Metodo ISyncMgrHandlerCollection::GetHandlerEnumerator (syncmgr.h)

Ottiene un enumeratore che fornisce l'accesso agli ID dei gestori di sincronizzazione esposti e gestiti dall'utente.

Sintassi

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

Parametri

[out] ppenum

Tipo: IEnumString**

Quando termina, questo metodo contiene un indirizzo di un puntatore a un'istanza di IEnumString che enumera gli ID dei gestori di sincronizzazione noti.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Un ID gestore di sincronizzazione è una stringa che rappresenta in modo univoco il gestore. L'ID deve essere univoco in tutti i gestori del sistema ed è limitato a una lunghezza massima di MAX_SYNCMGR_ID, incluso il carattere Null di terminazione.

Le versioni precedenti di Windows si basavano sui GUID per rappresentare gli ID del gestore e dell'elemento. Windows Vista usa stringhe per una maggiore flessibilità. È comunque consigliabile che la stringa contenga un GUID per garantire l'univocità, ma può anche contenere altre informazioni sull'uso per il gestore, specifiche per l'applicazione o il dispositivo.

Requisiti