Funzione EvtGetExtendedStatus (winevt.h)

Articolo
08/27/2023

Ottiene un messaggio di testo contenente le informazioni di errore estese per l'errore corrente.

Sintassi

DWORD EvtGetExtendedStatus(
  [in]  DWORD  BufferSize,
  [in]  LPWSTR Buffer,
  [out] PDWORD BufferUsed
);

Parametri

[in] BufferSize

Dimensioni del buffer buffer , in caratteri.

[in] Buffer

Buffer stringa allocato dal chiamante che riceverà le informazioni di errore estese. È possibile impostare questo parametro su NULL per determinare le dimensioni del buffer necessarie.

[out] BufferUsed

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

Valore restituito

Il valore restituito è ERROR_SUCCESS se la chiamata ha avuto esito positivo; in caso contrario, un codice di errore Win32.

Commenti

È necessario chiamare questa funzione nel thread che ha generato l'errore e prima di chiamare un'altra funzione registro eventi di Windows.

Le funzioni EvtQuery e EvtSubscribe possono fornire informazioni di errore estese se si verifica un problema con XPath specificato. Ad esempio, le informazioni sull'errore possono identificare il carattere in XPath in cui si è verificato un errore di analisi. Per ricevere le informazioni di errore estese per un XPath non valido, non è possibile specificare il flag EvtQueryTolerateQueryErrors quando si chiama EvtQuery o EvtSubscribe.

Requisiti


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

Condividi tramite