Compartir a través de

Función EvtGetPublisherMetadataProperty (winevt.h)

  • Artículo

Obtiene la propiedad de metadatos del proveedor especificada.

Sintaxis

BOOL EvtGetPublisherMetadataProperty(
  [in]  EVT_HANDLE                         PublisherMetadata,
  [in]  EVT_PUBLISHER_METADATA_PROPERTY_ID PropertyId,
  [in]  DWORD                              Flags,
  [in]  DWORD                              PublisherMetadataPropertyBufferSize,
  [in]  PEVT_VARIANT                       PublisherMetadataPropertyBuffer,
  [out] PDWORD                             PublisherMetadataPropertyBufferUsed
);

Parámetros

[in] PublisherMetadata

Identificador de los metadatos que devuelve la función EvtOpenPublisherMetadata .

[in] PropertyId

Identificador de la propiedad de metadatos que se va a recuperar. Para obtener una lista de identificadores de propiedad, consulte la enumeración EVT_PUBLISHER_METADATA_PROPERTY_ID .

[in] Flags

Reservado. Debe ser cero.

[in] PublisherMetadataPropertyBufferSize

Tamaño del búfer PublisherMetadataPropertyBuffer , en bytes.

[in] PublisherMetadataPropertyBuffer

Un búfer asignado por el autor de la llamada que recibirá la propiedad de metadatos. El búfer contiene un objeto EVT_VARIANT . Puede establecer este parámetro en NULL para determinar el tamaño de búfer necesario.

[out] PublisherMetadataPropertyBufferUsed

Tamaño, en bytes, del búfer asignado por el autor de la llamada que usó la función o el tamaño de búfer necesario si se produce un error en la función con ERROR_INSUFFICIENT_BUFFER.

Valor devuelto

Código o valor devuelto Descripción
TRUE
 La función se ha realizado correctamente.
FALSE
 Error en la función. Para obtener el código de error, llame a la función GetLastError .

Comentarios

Precaución  

EvtGetEventMetadataProperty puede devolver muchos tipos diferentes de valores en la variable EventMetadataPropertyBuffer . Si EventMetadataPropertyBuffer-Type> == EvtVarTypeEvtHandle, EventMetadataPropertyBuffer contiene un identificador que debe liberarse. Cuando haya terminado con el identificador, llame a la función EvtClose .

 

Ejemplos

Para obtener un ejemplo que muestra cómo usar esta función, consulte Obtención de metadatos de un proveedor.

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 winevt.h
Library Wevtapi.lib
Archivo DLL Wevtapi.dll

Consulte también

EvtOpenPublisherMetadata