EvtOpenSession 関数 (winevt.h)

他の Windows イベント ログ関数を呼び出すときに使用できるリモート コンピューターへの接続を確立します。

構文

EVT_HANDLE EvtOpenSession(
  [in] EVT_LOGIN_CLASS LoginClass,
  [in] PVOID           Login,
  [in] DWORD           Timeout,
  [in] DWORD           Flags
);

パラメーター

[in] LoginClass

リモート コンピューターへの接続に使用する接続方法。 使用可能な値については、 EVT_LOGIN_CLASS 列挙体を参照してください。

[in] Login

接続するリモート コンピューター、ユーザーの資格情報、接続時に使用する認証の種類を識別するEVT_RPC_LOGIN構造。

[in] Timeout

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

[in] Flags

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

戻り値

成功した場合、関数は、リモート コンピューター上のイベント ログ情報にアクセスするために使用できるセッション ハンドルを返します。それ以外の場合は NULL。 NULL の場合は、GetLastError 関数を呼び出してエラー コードを取得します。

注釈

セッション ハンドルが完了したら、 EvtClose 関数を呼び出します。 セッション ハンドルを閉じると、セッションで作成されたすべての開いているハンドルも閉じます (開いているハンドルを閉じると、それらのハンドルの現在のアクティビティが取り消されます)。

リモート コンピューターに接続するには、リモート コンピューターで "リモート イベント ログ管理" Windows ファイアウォール例外を有効にする必要があります。それ以外の場合、セッション ハンドルを使用しようとすると、RPC_S_SERVER_UNAVAILABLEで呼び出しがエラーになります。 接続先のコンピューターが Windows Vista 以降を実行している必要があります。

この関数は資格情報を検証しません。資格情報は、セッション ハンドルを初めて使用しようとするときに検証されます。 資格情報が無効な場合、呼び出しはERROR_ACCESS_DENIEDで失敗します。

例

この関数の使用方法を示す例については、「 リモート コンピューターへのアクセス」を参照してください。

要件

こちらもご覧ください

EVT_LOGIN_CLASS

EvtClose