Compartir a través de

Función EvtGetObjectArrayProperty (winevt.h)

  • Artículo

Obtiene una propiedad de metadatos del proveedor del objeto especificado en la matriz.

Sintaxis

BOOL EvtGetObjectArrayProperty(
  [in]  EVT_OBJECT_ARRAY_PROPERTY_HANDLE ObjectArray,
  [in]  DWORD                            PropertyId,
  [in]  DWORD                            ArrayIndex,
  [in]  DWORD                            Flags,
  [in]  DWORD                            PropertyValueBufferSize,
  [in]  PEVT_VARIANT                     PropertyValueBuffer,
  [out] PDWORD                           PropertyValueBufferUsed
);

Parámetros

[in] ObjectArray

Identificador de una matriz de objetos que devuelve la función EvtGetPublisherMetadataProperty .

[in] PropertyId

Identificador de propiedad de la propiedad de metadatos que desea obtener del objeto especificado. Para obtener los valores posibles, consulte la sección Comentarios de EVT_PUBLISHER_METADATA_PROPERTY_ID.

[in] ArrayIndex

Índice de base cero del objeto de la matriz.

[in] Flags

Reservado. Debe ser cero.

[in] PropertyValueBufferSize

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

[in] PropertyValueBuffer

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] PropertyValueBufferUsed

Tamaño, en bytes, del búfer asignado por el autor de la llamada que la función usó 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

Cuando se llama a la función EvtGetPublisherMetadataProperty con los siguientes identificadores, la función devuelve un identificador a una matriz de objetos de ese tipo:

  • EvtPublisherMetadataChannelReferences
  • EvtPublisherMetadataLevels
  • EvtPublisherMetadataTasks
  • EvtPublisherMetadataOpcodes
  • EvtPublisherMetadataKeywords
Por ejemplo, si pasa EvtPublisherMetadataKeywords a EvtGetPublisherMetadataProperty, la función devuelve un identificador a una matriz de objetos de palabra clave.

Para determinar el tamaño de la matriz, llame a la función EvtGetObjectArraySize .

Ejemplos

Para ver 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

EVT_PUBLISHER_METADATA_PROPERTY_ID

EvtGetPublisherMetadataProperty