Função TdhGetManifestEventInformation (tdh.h)

  • Artigo

A função TdhGetManifestEventInformation recupera metadados sobre um evento em um manifesto.

Sintaxe

TDHSTATUS TdhGetManifestEventInformation(
  [in]      LPGUID            ProviderGuid,
  [in]      PEVENT_DESCRIPTOR EventDescriptor,
  [out]     PTRACE_EVENT_INFO Buffer,
  [in, out] ULONG             *BufferSize
);

Parâmetros

[in] ProviderGuid

Um GUID que identifica o provedor de manifesto cujos metadados de evento você deseja recuperar.

[in] EventDescriptor

Um ponteiro para o descritor de evento que contém informações como id de evento, versão, op-code e palavra-chave. Para obter detalhes, consulte a estrutura EVENT_DESCRIPTOR

[out] Buffer

Um buffer alocado pelo usuário para receber os metadados sobre um evento em um manifesto do provedor. Para obter detalhes, consulte a estrutura TRACE_EVENT_INFO .

[in, out] BufferSize

O tamanho, em bytes, do buffer apontado pelo parâmetro Buffer . 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 apontado pelo parâmetro Buffer é muito pequeno. Use o tamanho do buffer necessário definido 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 para o 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

TRACE_EVENT_INFO

TdhEnumerateManifestProviderEvents