Funzione EvtGetObjectArrayProperty (winevt.h)

Articolo
03/04/2024

Ottiene una proprietà dei metadati del provider dall'oggetto specificato nella matrice.

Sintassi

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
);

Parametri

[in] ObjectArray

Handle per una matrice di oggetti restituiti dalla funzione EvtGetPublisherMetadataProperty .

[in] PropertyId

Identificatore della proprietà dei metadati che si desidera ottenere dall'oggetto specificato. Per i valori possibili, vedere la sezione Osservazioni di EVT_PUBLISHER_METADATA_PROPERTY_ID.

[in] ArrayIndex

Indice in base zero dell'oggetto nella matrice.

[in] Flags

Riservato. Deve essere zero.

[in] PropertyValueBufferSize

Dimensioni del buffer PropertyValueBuffer , in byte.

[in] PropertyValueBuffer

Buffer allocato dal chiamante che riceverà la proprietà dei metadati. Il buffer contiene un oggetto EVT_VARIANT . È possibile impostare questo parametro su NULL per determinare le dimensioni del buffer necessarie.

[out] PropertyValueBufferUsed

Dimensione, in byte, del buffer allocato dal chiamante utilizzato dalla funzione o dalla dimensione del buffer necessaria se la funzione ha esito negativo con ERROR_INSUFFICIENT_BUFFER.

Valore restituito

Codice/valore restituito	Descrizione
TRUE	Funzione completata.
FALSE	La funzione non è riuscita. Per ottenere il codice di errore, chiamare la funzione GetLastError .

Commenti

Quando si chiama la funzione EvtGetPublisherMetadataProperty con gli ID seguenti, la funzione restituisce un handle a una matrice di oggetti di quel tipo:

EvtPublisherMetadataChannelReferences
EvtPublisherMetadataLevels
EvtPublisherMetadataTasks
EvtPublisherMetadataOpcodes
EvtPublisherMetadataKeywords

Ad esempio, se si passa EvtPublisherMetadataKeywords a EvtGetPublisherMetadataProperty, la funzione restituisce un handle a una matrice di oggetti parola chiave.

Per determinare le dimensioni della matrice, chiamare la funzione EvtGetObjectArraySize .

Esempio

Per un esempio che illustra come usare questa funzione, vedere Recupero dei metadati di un provider.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winevt.h
Libreria	Wevtapi.lib
DLL	Wevtapi.dll

Vedi anche

EVT_PUBLISHER_METADATA_PROPERTY_ID

EvtGetPublisherMetadataProperty

Condividi tramite