Méthode ISyncMgrHandlerCollection::GetHandlerEnumerator (syncmgr.h)

Obtient un énumérateur qui fournit l’accès aux ID des gestionnaires de synchronisation exposés et gérés par l’utilisateur.

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

[out] ppenum

Type : IEnumString**

Lorsque cette méthode retourne, contient l’adresse d’un pointeur vers un instance d’IEnumString qui énumère les ID des gestionnaires de synchronisation connus.

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Un ID de gestionnaire de synchronisation est une chaîne qui représente de manière unique le gestionnaire. L’ID doit être unique parmi tous les gestionnaires du système et est limité à une longueur maximale de MAX_SYNCMGR_ID, y compris le caractère null de fin.

Les versions antérieures de Windows s’appuyaient sur des GUID pour représenter les ID de gestionnaire et d’élément. Windows Vista utilise des chaînes pour leur plus grande flexibilité. Il est toujours recommandé que la chaîne contienne un GUID pour garantir l’unicité, mais elle peut également contenir d’autres informations d’utilisation pour le gestionnaire, spécifiques à l’application ou à l’appareil.