Funzione EvtGetEventInfo (winevt.h)

Ottiene informazioni che identificano la query XML strutturata che ha selezionato l'evento e il file di canale o di log che contiene l'evento.

Sintassi

BOOL EvtGetEventInfo(
  [in]  EVT_HANDLE            Event,
  [in]  EVT_EVENT_PROPERTY_ID PropertyId,
  [in]  DWORD                 PropertyValueBufferSize,
  [in]  PEVT_VARIANT          PropertyValueBuffer,
  [out] PDWORD                PropertyValueBufferUsed
);

Parametri

[in] Event

Handle a un evento per il quale si desidera recuperare informazioni.

[in] PropertyId

Flag che identifica le informazioni da recuperare. Ad esempio, l'identificatore di query o il percorso. Per i valori possibili, vedere l'enumerazione EVT_EVENT_PROPERTY_ID .

[in] PropertyValueBufferSize

Dimensioni del buffer PropertyValueBuffer , in byte.

[in] PropertyValueBuffer

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

[out] PropertyValueBufferUsed

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

Commenti

Se la query passata a EvtQuery o EvtSubscribe è una query XPath anziché una query XML strutturata, l'identificatore di query sarà zero e il percorso sarà il percorso passato alla funzione.

Requisiti