Função TdhEnumerateProviders (tdh.h)

  • Artigo

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

Confira também

TdhEnumerateProviderFieldInformation