Função TdhEnumerateManifestProviderEvents (tdh.h)

  • Artigo

A função TdhEnumerateManifestProviderEvents recupera a lista de eventos presentes no manifesto do provedor.

Sintaxe

TDHSTATUS TdhEnumerateManifestProviderEvents(
  [in]      LPGUID               ProviderGuid,
  [out]     PPROVIDER_EVENT_INFO Buffer,
  [in, out] ULONG                *BufferSize
);

Parâmetros

[in] ProviderGuid

Um GUID que identifica o provedor de manifesto cuja lista de eventos você deseja recuperar.

[out] Buffer

Um buffer alocado pelo usuário para receber a lista de eventos. Para obter detalhes, consulte a estrutura PROVIDER_EVENT_INFO .

[in, out] BufferSize

O tamanho, em bytes, do buffer apontado pelo parâmetro ProviderInfo . 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.

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_EMPTY
 Não há eventos definidos para o GUID do provedor no manifesto.
ERROR_FILE_NOT_FOUND
 Os metadados do provedor não foram encontrados.
ERROR_INSUFFICIENT_BUFFER
 O tamanho do buffer ProviderInfo é muito pequeno. Use o conjunto de tamanho de buffer necessário no parâmetro BufferSize para alocar um novo buffer.
ERROR_INVALID_PARAMETER
 Um ou mais dos parâmetros não são válidos.
ERROR_NOT_FOUND
 As informações de esquema do GUID do provedor fornecido não foram encontradas.

Requisitos

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

Confira também

EVENT_DESCRIPTOR

PROVIDER_EVENT_INFO

TdhGetManifestEventInformation