Funzione EvtGetPublisherMetadataProperty (winevt.h)

Articolo
03/04/2024

Ottiene la proprietà dei metadati del provider specificata.

Sintassi

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

Parametri

[in] PublisherMetadata

Handle ai metadati restituiti dalla funzione EvtOpenPublisherMetadata .

[in] PropertyId

Identificatore della proprietà dei metadati da recuperare. Per un elenco di identificatori di proprietà, vedere l'enumerazione EVT_PUBLISHER_METADATA_PROPERTY_ID .

[in] Flags

Riservato. Deve essere zero.

[in] PublisherMetadataPropertyBufferSize

Dimensioni del buffer PublisherMetadataPropertyBuffer , in byte.

[in] PublisherMetadataPropertyBuffer

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

Dimensioni, 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

Attenzione

EvtGetEventMetadataProperty può restituire molti tipi diversi di valori nella variabile EventMetadataPropertyBuffer . Se EventMetadataPropertyBuffer-Type> == EvtVarTypeEvtHandle, EventMetadataPropertyBuffer contiene un handle che deve essere liberato. Al termine dell'handle, chiamare la funzione EvtClose .

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

EvtOpenPublisherMetadata

Condividi tramite