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で失敗します。
例
この関数の使用方法を示す例については、「 リモート コンピューターへのアクセス」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winevt.h |
| Library | Wevtapi.lib |
| [DLL] | Wevtapi.dll |