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

Obtém um enumerador que fornece acesso às IDs de manipuladores de sincronização expostos e gerenciados pelo usuário.

Sintaxe

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

Parâmetros

[out] ppenum

Tipo: IEnumString**

Quando esse método retorna, contém um endereço de um ponteiro para uma instância de IEnumString que enumera as IDs de manipuladores de sincronização conhecidos.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Uma ID do manipulador de sincronização é uma cadeia de caracteres que representa exclusivamente o manipulador. A ID deve ser exclusiva em todos os manipuladores do sistema e é limitada a um comprimento máximo de MAX_SYNCMGR_ID, incluindo o caractere nulo de terminação.

Versões anteriores do Windows dependiam de GUIDs para representar IDs de manipulador e item. O Windows Vista usa cadeias de caracteres para maior flexibilidade. Ainda é recomendável que a cadeia de caracteres contenha um GUID para garantir a exclusividade, mas também pode conter outras informações de uso para o manipulador, específicas do aplicativo ou do dispositivo.

Requisitos