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 イベント ログ関数を呼び出す前に、エラーを生成したスレッドでこの関数を呼び出す必要があります。

EvtQuery 関数と EvtSubscribe 関数は、指定された XPath に問題がある場合に、拡張エラー情報を提供できます。 たとえば、エラー情報は、解析エラーが発生した XPath 内の文字を識別できます。 形式が正しくない XPath の拡張エラー情報を受け取るために、EvtQuery または EvtSubscribe を呼び出すときに EvtQueryTolerateQueryErrors フラグを指定することはできません。

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	winevt.h
Library	Wevtapi.lib
[DLL]	Wevtapi.dll