Función TdhGetEventInformation (tdh.h)

  • Artículo

Recupera metadatos sobre un evento.

Sintaxis

TDHSTATUS TdhGetEventInformation(
  [in]      PEVENT_RECORD     Event,
  [in]      ULONG             TdhContextCount,
  [in]      PTDH_CONTEXT      TdhContext,
  [out]     PTRACE_EVENT_INFO Buffer,
  [in, out] PULONG            BufferSize
);

Parámetros

[in] Event

El registro de eventos pasado a la devolución de llamada eventRecordCallback . Para obtener más información, consulte la estructura EVENT_RECORD .

[in] TdhContextCount

Número de elementos de pTdhContext.

[in] TdhContext

Matriz de valores de contexto solo para eventos DE WPP o ETW clásico; en caso contrario, NULL. Para obtener más información, consulte la estructura TDH_CONTEXT . La matriz no debe contener tipos de contexto duplicados.

[out] Buffer

Búfer asignado por el usuario para recibir la información del evento. Para obtener más información, consulte la estructura TRACE_EVENT_INFO .

[in, out] BufferSize

Tamaño, en bytes, del búfer de pBuffer . Si la función se realiza correctamente, este parámetro recibe el tamaño del búfer usado. Si el búfer es demasiado pequeño, la función devuelve ERROR_INSUFFICIENT_BUFFER y establece este parámetro en el tamaño de búfer necesario. Si el tamaño del búfer es cero en la entrada, no se devuelve ningún dato en el búfer y este parámetro recibe el tamaño de búfer necesario.

Valor devuelto

Devuelve ERROR_SUCCESS si se ejecuta correctamente. De lo contrario, esta función devuelve uno de los siguientes códigos de retorno además de otros.

Código devuelto Descripción
ERROR_INSUFFICIENT_BUFFER
 El tamaño del búfer de pBuffer es demasiado pequeño. Use el tamaño de búfer necesario establecido en pBufferSize para asignar un nuevo búfer.
ERROR_NOT_FOUND
 No se encontró el esquema del evento.
ERROR_INVALID_PARAMETER
 Uno o varios de los parámetros no son válidos.
ERROR_FILE_NOT_FOUND
 El atributo resourceFileName del manifiesto contiene la ubicación del binario del proveedor. Al registrar el manifiesto, la ubicación se escribe en el Registro. TDH no pudo encontrar el binario en función de la ubicación registrada.
ERROR_WMI_SERVER_UNAVAILABLE
 El servicio WMI no está disponible.

Comentarios

Si el evento es un evento DE WPP o ETW heredado, puede especificar información de contexto que se usa para ayudar a analizar la información del evento. El evento es un evento WPP si la marca EVENT_HEADER_FLAG_TRACE_MESSAGE está establecida en el miembro Flags de EVENT_HEADER (vea el miembro EventHeader de EVENT_RECORD). El evento es un evento ETW heredado si se establece la marca EVENT_HEADER_FLAG_CLASSIC_HEADER.

Ejemplos

Para obtener un ejemplo que muestra cómo recuperar metadatos sobre un evento, consulte Uso de TdhFormatProperty para consumir datos de eventos.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado tdh.h
Library Tdh.lib
Archivo DLL Tdh.dll

Consulte también

TdhGetEventMapInformation

TdhGetProperty