Funzione TdhEnumerateProviders (tdh.h)
Recupera un elenco di tutti i provider registrati nel computer.
Sintassi
TDHSTATUS TdhEnumerateProviders(
[out] PPROVIDER_ENUMERATION_INFO pBuffer,
[in, out] ULONG *pBufferSize
);
Parametri
[out] pBuffer
Matrice di provider che definiscono pubblicamente gli eventi nel computer. Per informazioni dettagliate, vedere la struttura PROVIDER_ENUMERATION_INFO .
[in, out] pBufferSize
Dimensioni, in byte, del buffer pBuffer . Se la funzione ha esito positivo, questo parametro riceve le dimensioni del buffer usato. Se il buffer è troppo piccolo, la funzione restituisce ERROR_INSUFFICIENT_BUFFER e imposta questo parametro sulla dimensione del buffer necessaria. Se la dimensione del buffer è zero in input, nessun dato viene restituito nel buffer e questo parametro riceve le dimensioni del buffer necessarie.
Valore restituito
Restituisce ERROR_SUCCESS se riuscito. In caso contrario, questa funzione restituisce uno dei codici restituiti seguenti oltre ad altri.
Codice restituito | Descrizione |
---|---|
ERROR_INSUFFICIENT_BUFFER | Le dimensioni del buffer pBuffer sono troppo piccole. Usare il set di dimensioni del buffer richiesto in pBufferSize per allocare un nuovo buffer. |
ERROR_INVALID_PARAMETER | Uno o più parametri non sono validi. |
Commenti
Chiamare la funzione TdhEnumerateProvidersForDecodingSource per recuperare un elenco di provider che hanno registrato una classe MOF o un file manifesto nel computer.
Poiché il numero di provider di eventi registrati può variare tra le chiamate a questa funzione, è consigliabile inserire questa funzione in un ciclo che non esegue il ciclo fino a quando il valore restituito non è più ERROR_INSUFFICIENT_BUFFER.
Esempio
Per un esempio che illustra come enumerare i provider, vedere Enumerazione dei provider.
Requisiti
Client minimo supportato | Windows Vista [solo app desktop] |
Server minimo supportato | Windows Server 2008 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | tdh.h |
Libreria | Tdh.lib |
DLL | Tdh.dll |