ISyncMgrSyncCallback::QueryForAdditionalItems-Methode (syncmgr.h)

Artikel
03/02/2024

Ruft einen Enumerator der Gruppe von Elementen ab, die über eine ausstehende Anforderung verfügen, die synchronisiert werden soll. Dies ist der Satz von Elementen, die nach Abschluss der aktuellen Synchronisierung synchronisiert werden.

Syntax

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

Parameter

[out] ppenumItemIDs

Typ: IEnumString**

Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf eine instance von IEnumString, die Synchronisierungselement-IDs aufzählt. Dieser Wert ist NULL , wenn keine Elemente ausstehen.

[out] ppenumPunks

Typ: IEnumUnknown**

Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf eine instance von IEnumUnknown, die IUnknown-Schnittstellen aufzählt, die an StartHandlerSync oder StartItemSync übergeben werden. Dieser Wert ist NULL , wenn keine Schnittstellen ausstehen.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen Fehlerwert zurück. Gibt S_FALSE zurück, wenn keine Elemente ausstehen.

Hinweise

Element-IDs, die durch einen Aufruf der Next-Methode der abgerufenen Enumeratorschnittstelle abgerufen werden, weisen eine maximale Länge von MAX_SYNCMGR_ID einschließlich des beendenden NULL-Zeichens auf. Die aufrufende Anwendung ist für die Zuordnung jeder Element-ID verantwortlich, die über die Next-Methode mithilfe von CoTaskMemFree abgerufen wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	syncmgr.h

Freigeben über