EvtOpenLog 関数 (winevt.h)

チャネルまたはログファイルへのハンドルを取得します。このハンドルを使用して、チャネルまたはログファイルに関する情報を取得できます。

構文

EVT_HANDLE EvtOpenLog(
  [in] EVT_HANDLE Session,
  [in] LPCWSTR    Path,
  [in] DWORD      Flags
);

[in] Session

EvtOpenSession 関数が返すリモートセッションハンドル。チャネルを開くか、ローカルコンピューターにログオンするには 、NULL に設定します。

[in] Path

エクスポートされたログファイルへのチャネルまたは完全パスの名前。

[in] Flags

Path パラメーターがログファイルまたはチャネルを指しているかどうかを決定するフラグ。使用できる値については、 EVT_OPEN_LOG_FLAGS 列挙を参照してください。

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

相対パスと環境変数は、ファイルを指定するときに使用できません。汎用名前付け規則 (UNC) パスを使用してファイルを検索できます。 API 呼び出しを行う前に、相対パスと環境変数の拡張を行う必要があります。

チャネルまたはログファイルに関する情報を取得するには、 EvtGetLogInfo 関数を呼び出します。