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 |
---|---|
|
Funzione completata. |
|
La funzione non è riuscita. Per ottenere il codice di errore, chiamare la funzione GetLastError . |
Commenti
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 |