EvtGetExtendedStatus 函式 (winevt.h)

取得文字訊息，其中包含目前錯誤的擴充錯誤資訊。

語法

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

參數

[in] BufferSize

緩衝區的大小，以字元為單位。

[in] Buffer

呼叫端配置的字串緩衝區，將接收擴充錯誤資訊。 您可以將此參數設定為 Null ，以判斷所需的緩衝區大小。

[out] BufferUsed

如果函式因ERROR_INSUFFICIENT_BUFFER而失敗，則呼叫端配置緩衝區的大小，或所需的緩衝區大小。

傳回值

如果呼叫成功，則會ERROR_SUCCESS傳回值;否則為 Win32 錯誤碼。

備註

您必須在產生錯誤的執行緒上呼叫此函式，以及呼叫另一個 Windows 事件記錄檔函式之前。

如果指定的 XPath 發生問題， EvtQuery 和 EvtSubscribe 函式可以提供擴充錯誤資訊。 例如，錯誤資訊可以識別 XPath 中發生剖析錯誤的字元。 若要接收格式錯誤的 XPath 擴充錯誤資訊，您無法在呼叫 EvtQuery 或 EvtSubscribe時指定 EvtQueryTolerateQueryErrors 旗標。

規格需求