Compartir a través de

Función TdhGetEventMapInformation (tdh.h)

  • Artículo

Recupera información sobre el mapa de eventos contenido en el evento.

Sintaxis

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

Parámetros

[in] pEvent

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

[in] pMapName

Cadena Unicode terminada en NULL que contiene el nombre del valor del atributo de mapa. El nombre procede del miembro MapNameOffset de la estructura EVENT_PROPERTY_INFO .

[out] pBuffer

Búfer asignado por el usuario para recibir el mapa de eventos. El mapa podría ser un mapa de valores, un mapa de bits o un mapa de patrones. Para obtener más información, consulte la estructura EVENT_MAP_INFO .

[in, out] pBufferSize

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 o no se encontró la asignación especificada.
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_INVALID_PARAMETER
 Uno o varios de los parámetros no son válidos.
ERROR_WMI_SERVER_UNAVAILABLE
 El servicio WMI no está disponible.

Comentarios

No se puede usar esta función para recuperar información de mapa de eventos para eventos de WPP.

En el caso de los mapas definidos en un manifiesto, la cadena contendrá un espacio al final de la cadena. Por ejemplo, si el valor se asigna a "Monday" en el manifiesto, la cadena se devuelve como "Monday".

Ejemplos

Para obtener un ejemplo que muestra cómo llamar a esta función, vea Using TdhGetProperty to Consume Event Data.

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