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