Funzione EvtGetPublisherMetadataProperty (winevt.h)

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