Función TdhGetManifestEventInformation (tdh.h)

  • Artículo

La función TdhGetManifestEventInformation recupera metadatos sobre un evento en un manifiesto.

Sintaxis

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

Parámetros

[in] ProviderGuid

GUID que identifica el proveedor de manifiestos cuyos metadatos de eventos desea recuperar.

[in] EventDescriptor

Puntero al descriptor de eventos que contiene información como el identificador de evento, la versión, el código de operación y la palabra clave. Para obtener más información, consulte la estructura de EVENT_DESCRIPTOR .

[out] Buffer

Un búfer asignado por el usuario para recibir los metadatos sobre un evento en un manifiesto de proveedor. Para obtener más información, consulte la estructura TRACE_EVENT_INFO .

[in, out] BufferSize

Tamaño, en bytes, del búfer al que apunta el parámetro Buffer . 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_EMPTY
 No hay ningún evento definido para el GUID del proveedor en el manifiesto.
ERROR_FILE_NOT_FOUND
 No se encontraron los metadatos del proveedor.
ERROR_INSUFFICIENT_BUFFER
 El tamaño del búfer al que apunta el parámetro Buffer es demasiado pequeño. Use el tamaño de búfer necesario establecido en el parámetro BufferSize para asignar un nuevo búfer.
ERROR_INVALID_PARAMETER
 Uno o varios de los parámetros no son válidos.
ERROR_NOT_FOUND
 No se encontró la información de esquema para el GUID del proveedor proporcionado.

Requisitos

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

Consulte también

EVENT_DESCRIPTOR

PROVIDER_EVENT_INFO

TRACE_EVENT_INFO

TdhEnumerateManifestProviderEvents