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 関数を呼び出してハンドルを閉じる必要があります。

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