ISyncMgrSyncCallback::QueryForAdditionalItems method (syncmgr.h)

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

[out] ppenumItemIDs

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.

[out] ppenumPunks

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

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header syncmgr.h