ISyncMgrSyncCallback::QueryForAdditionalItems method

Retrieves an enumerator of the set of items that have a pending request to be synchronized. This is the set of items that will be synchronized after the current synchronization is finished.

Syntax


HRESULT QueryForAdditionalItems(
  [out] IEnumString  **ppenumItemIDs,
  [out] IEnumUnknown **ppenumPunks
);

Parameters

ppenumItemIDs [out]

Type: IEnumString**

When this method returns, contains the address of a pointer to an instance of IEnumString that enumerates sync item IDs. This value is NULL if no items are pending.

ppenumPunks [out]

Type: IEnumUnknown**

When this method returns, contains the address of a pointer to an instance of IEnumUnknown enumerating IUnknown interfaces that are passed to StartHandlerSync or StartItemSync. This value is NULL if no interfaces are pending.

Return value

Type: HRESULT

Returns S_OK if successful, or an error value otherwise. Returns S_FALSE if no items are pending.

Remarks

Item IDs retrieved by a call to the Next method of the retrieved enumerator interface have a maximum length of MAX_SYNCMGR_ID including the terminating null character. The calling application is responsible for deallocating each item ID retrieved through the Next method by using CoTaskMemFree.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Syncmgr.h

IDL

Syncmgr.idl

 

 

Show: