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 |