EvtNextChannelPath 関数 (winevt.h)
列挙子からチャネル名を取得します。
構文
BOOL EvtNextChannelPath(
[in] EVT_HANDLE ChannelEnum,
[in] DWORD ChannelPathBufferSize,
[in] LPWSTR ChannelPathBuffer,
[out] PDWORD ChannelPathBufferUsed
);
パラメーター
[in] ChannelEnum
EvtOpenChannelEnum 関数が返す列挙子へのハンドル。
[in] ChannelPathBufferSize
ChannelPathBuffer バッファーのサイズ (文字数)。
[in] ChannelPathBuffer
チャネルの名前を受け取る呼び出し元によって割り当てられたバッファー。 このパラメーターを NULL に設定して、必要なバッファー サイズを決定できます。
[out] ChannelPathBufferUsed
関数が使用した呼び出し元割り当てバッファーのサイズ (文字単位)、または関数が ERROR_INSUFFICIENT_BUFFER で失敗した場合に必要なバッファー サイズ。
戻り値
リターン コード/値 | 説明 |
---|---|
|
関数が正常に実行されました。 |
|
関数が失敗しました。 エラー コードを取得するには、 GetLastError 関数を呼び出します。 |
注釈
関数が FALSE を 返し、エラー コードがERROR_NO_MORE_ITEMSされるまで、ループ内でこの関数を呼び出します。
例
この関数の使用方法を示す例については、「チャネルの 構成プロパティの取得と設定」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | winevt.h |
Library | Wevtapi.lib |
[DLL] | Wevtapi.dll |