EvtGetQueryInfo 関数 (winevt.h)
クエリがアクセスしようとしたチャネルまたはログ ファイルの一覧を識別する、実行したクエリに関する情報を取得します。 関数は、各アクセスの成功または失敗を示すリターン コードの一覧も取得します。
構文
BOOL EvtGetQueryInfo(
[in] EVT_HANDLE QueryOrSubscription,
[in] EVT_QUERY_PROPERTY_ID PropertyId,
[in] DWORD PropertyValueBufferSize,
[in] PEVT_VARIANT PropertyValueBuffer,
[out] PDWORD PropertyValueBufferUsed
);
パラメーター
[in] QueryOrSubscription
EvtQuery または EvtSubscribe 関数が返すクエリのハンドル。
[in] PropertyId
取得するクエリ情報の識別子。 識別子の一覧については、 EVT_QUERY_PROPERTY_ID 列挙を参照してください。
[in] PropertyValueBufferSize
PropertyValueBuffer バッファーのサイズ (バイト単位)。
[in] PropertyValueBuffer
クエリ情報を受け取る呼び出し元によって割り当てられたバッファー。 バッファーには 、EVT_VARIANT オブジェクトが含まれています。 このパラメーターを NULL に設定して、必要なバッファー サイズを決定できます。
[out] PropertyValueBufferUsed
関数が使用した呼び出し元によって割り当てられたバッファーのサイズ (バイト単位)、または関数が ERROR_INSUFFICIENT_BUFFER で失敗した場合は必要なバッファー サイズ。
戻り値
| リターン コード/値 | 説明 |
|---|---|
|
関数が正常に実行されました。 |
|
関数が失敗しました。 エラー コードを取得するには、 GetLastError 関数を呼び出します。 |
注釈
EvtQueryTolerateQueryErrors フラグを EvtQuery に渡すか、EvtSubscribeTolerateQueryErrors フラグを EvtSubscribe に渡す場合にのみ、この関数を呼び出す必要があります。
例
この関数の使用方法を示す例については、「 イベントのクエリ」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winevt.h |
| Library | Wevtapi.lib |
| [DLL] | Wevtapi.dll |