ISyncMgrHandlerCollection::GetHandlerEnumerator-Methode (syncmgr.h)

Artikel
08/26/2023

Ruft einen Enumerator ab, der Zugriff auf die IDs von Synchronisierungshandlern bietet, die dem Benutzer verfügbar gemacht und vom Benutzer verwaltet werden.

Syntax

HRESULT GetHandlerEnumerator(
  [out] IEnumString **ppenum
);

Parameter

[out] ppenum

Typ: IEnumString**

Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf eine instance von IEnumString, die die IDs bekannter Synchronisierungshandler aufzählt.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Eine Synchronisierungshandler-ID ist eine Zeichenfolge, die den Handler eindeutig darstellt. Die ID muss für alle Handler im System eindeutig sein und ist auf eine maximale Länge von MAX_SYNCMGR_ID beschränkt, einschließlich des beendenden NULL-Zeichens.

Frühere Versionen von Windows basierten auf GUIDs, um Handler- und Element-IDs darzustellen. Windows Vista verwendet Zeichenfolgen für ihre größere Flexibilität. Es wird weiterhin empfohlen, dass die Zeichenfolge eine GUID enthält, um die Eindeutigkeit sicherzustellen, aber sie kann auch andere Informationen enthalten, die für den Handler verwendet werden, spezifisch für die Anwendung oder das Gerät.

Anforderungen


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