Função TdhEnumerateProviders (tdh.h)
Recupera uma lista de todos os provedores que se registraram no computador.
Sintaxe
TDHSTATUS TdhEnumerateProviders(
[out] PPROVIDER_ENUMERATION_INFO pBuffer,
[in, out] ULONG *pBufferSize
);
Parâmetros
[out] pBuffer
Matriz de provedores que definem publicamente seus eventos no computador. Para obter detalhes, consulte a estrutura PROVIDER_ENUMERATION_INFO .
[in, out] pBufferSize
Tamanho, em bytes, do buffer pBuffer . Se a função for bem-sucedida, esse parâmetro receberá o tamanho do buffer usado. Se o buffer for muito pequeno, a função retornará ERROR_INSUFFICIENT_BUFFER e definirá esse parâmetro como o tamanho do buffer necessário. Se o tamanho do buffer for zero na entrada, nenhum dado será retornado no buffer e esse parâmetro receberá o tamanho do buffer necessário.
Valor retornado
Retorna ERROR_SUCCESS se tiver êxito. Caso contrário, essa função retornará um dos seguintes códigos de retorno, além de outros.
| Código de retorno | Descrição |
|---|---|
| ERROR_INSUFFICIENT_BUFFER | O tamanho do buffer pBuffer é muito pequeno. Use o tamanho do buffer necessário definido em pBufferSize para alocar um novo buffer. |
| ERROR_INVALID_PARAMETER | Um ou mais dos parâmetros não são válidos. |
Comentários
Chame a função TdhEnumerateProvidersForDecodingSource para recuperar uma lista de provedores que registraram uma classe MOF ou um arquivo de manifesto no computador.
Como o número de provedores de eventos registrados pode flutuar entre chamadas para essa função, você deve colocar essa função em um loop que loops até que o valor retornado não seja mais ERROR_INSUFFICIENT_BUFFER.
Exemplos
Para obter um exemplo que mostra como enumerar provedores, consulte Enumerando Provedores.
Requisitos
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | tdh.h |
| Biblioteca | Tdh.lib |
| DLL | Tdh.dll |