EvtOpenChannelConfig 関数 (winevt.h)

チャネルの構成プロパティの読み取りまたは変更に使用するハンドルを取得します。

構文

EVT_HANDLE EvtOpenChannelConfig(
  [in] EVT_HANDLE Session,
  [in] LPCWSTR    ChannelPath,
  [in] DWORD      Flags
);

パラメーター

[in] Session

EvtOpenSession 関数が返すリモート セッション ハンドル。 ローカル コンピューター上のチャネルにアクセスするには、 NULL に設定します。

[in] ChannelPath

アクセスするチャネルの名前。

[in] Flags

予約済み。 ゼロを指定してください。

戻り値

成功した場合、関数はチャネルの構成にハンドルを返します。それ以外の場合は NULL。 NULL の場合は、GetLastError 関数を呼び出してエラー コードを取得します。

解説

構成プロパティを取得するには、 EvtGetChannelConfigProperty 関数を呼び出します。

構成プロパティを変更するには、 EvtSetChannelConfigProperty 関数を呼び出します。 構成の変更を保存するには、 EvtSaveChannelConfig 関数を呼び出します。

登録済みチャネルを列挙するには、 EvtOpenChannelEnum 関数を呼び出します。

完了したら、 EvtClose 関数を呼び出してハンドルを閉じる必要があります。

例

この関数の使用方法を示す例については、「チャネルの 構成プロパティの取得と設定」を参照してください。

要件

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

関連項目

EvtGetChannelConfigProperty

EvtOpenChannelEnum

EvtSaveChannelConfig

EvtSetChannelConfigProperty