Share via

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 関数を呼び出します。

要件

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

関連項目

EvtClearLog

EvtExportLog

EvtGetLogInfo