Função TdhEnumerateProviderFilters (tdh.h)

  • Artigo

A função TdhEnumerateProviderFilters enumera os filtros que o provedor especificado definiu no manifesto.

Sintaxe

TDHSTATUS TdhEnumerateProviderFilters(
  [in]            LPGUID                Guid,
  [in]            ULONG                 TdhContextCount,
  [in, optional]  PTDH_CONTEXT          TdhContext,
  [in]            ULONG                 *FilterCount,
  [out, optional] PPROVIDER_FILTER_INFO *Buffer,
  [in, out]       ULONG                 *BufferSize
);

Parâmetros

[in] Guid

GUID que identifica o provedor cujos filtros você deseja recuperar.

[in] TdhContextCount

Não usado.

[in, optional] TdhContext

Não usado.

[in] FilterCount

O número de estruturas de filtro que o buffer pBuffer contém. Será zero se o buffer pBuffer for insuficiente.

[out, optional] Buffer

Buffer alocado pelo usuário para receber as informações de filtro. Para obter detalhes, consulte a estrutura PROVIDER_FILTER_INFO .

[in, out] BufferSize

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 para 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.

Retornar valor

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 conjunto de tamanho de buffer necessário no pBufferSize para alocar um novo buffer.
ERROR_NOT_FOUND
 O esquema do evento não foi encontrado.
ERROR_INVALID_PARAMETER
 Um ou mais dos parâmetros não são válidos.
ERROR_FILE_NOT_FOUND
 O atributo resourceFileName no manifesto contém o local do binário do provedor. Quando você registra o manifesto, o local é gravado no registro. O TDH não pôde localizar o binário com base no local registrado.

Comentários

Essa função usa o manifesto XML para recuperar as informações.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho tdh.h
Biblioteca Tdh.lib
DLL Tdh.dll