Função TdhGetEventMapInformation (tdh.h)

  • Artigo

Recupera informações sobre o mapa de eventos contido no evento.

Sintaxe

TDHSTATUS TdhGetEventMapInformation(
  [in]      PEVENT_RECORD   pEvent,
  [in]      PWSTR           pMapName,
  [out]     PEVENT_MAP_INFO pBuffer,
  [in, out] ULONG           *pBufferSize
);

Parâmetros

[in] pEvent

O registro de evento passado para o retorno de chamada EventRecordCallback . Para obter detalhes, consulte a estrutura EVENT_RECORD .

[in] pMapName

Cadeia de caracteres Unicode terminada em nulo que contém o nome do valor do atributo do mapa. O nome vem do membro MapNameOffset da estrutura EVENT_PROPERTY_INFO .

[out] pBuffer

Buffer alocado pelo usuário para receber o mapa de eventos. O mapa pode ser um mapa de valor, bitmap ou mapa de padrões. Para obter detalhes, consulte a estrutura EVENT_MAP_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 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 ou o mapa especificado não foi encontrado.
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.
ERROR_INVALID_PARAMETER
 Um ou mais dos parâmetros não são válidos.
ERROR_WMI_SERVER_UNAVAILABLE
 O serviço WMI não está disponível.

Comentários

Você não pode usar essa função para recuperar informações de mapa de eventos para eventos WPP.

Para mapas definidos em um manifesto, a cadeia de caracteres conterá um espaço no final da cadeia de caracteres. Por exemplo, se o valor for mapeado para "Segunda-feira" no manifesto, a cadeia de caracteres será retornada como "Segunda-feira".

Exemplos

Para obter um exemplo que mostra como chamar essa função, consulte Usando TdhGetProperty para consumir dados de evento.

Requisitos

Requisito Valor
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