指定したイベント ログへの登録済みハンドルを取得します。
構文
HANDLE RegisterEventSourceA(
[in] LPCSTR lpUNCServerName,
[in] LPCSTR lpSourceName
);
パラメーター
[in] lpUNCServerName
この操作を実行するリモート サーバーの汎用名前付け規則 (UNC) 名。 このパラメーターが NULL
[in] lpSourceName
ハンドルを取得する
注 この文字列には、xml 属性で禁止されている文字を含めてはなりません。ただし、< &glなどの XML エスケープ シーケンスは除きます。
戻り値
関数が成功した場合、戻り値はイベント ログへのハンドルです。
関数が失敗した場合、戻り値は NULL
この関数は、lpSourceName が Security イベント ログを指定した場合、ERROR_ACCESS_DENIED を返します。
備考
ソース名が見つからない場合、イベント ログ サービスは アプリケーション ログを使用します。 イベントは報告されますが、イベント識別子に関連する説明を検索するためのメッセージ ファイルとカテゴリ メッセージ ファイルがないため、イベントには説明は含まれません。
イベント ログのハンドルを閉じるには、DeregisterEventSource 関数を使用します。
例
例については、「イベントの報告
手記
winbase.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして RegisterEventSource を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | winbase.h (Windows.h を含む) |
| ライブラリ | Advapi32.lib |
| DLL | Advapi32.dll |
関連項目
DeregisterEventSource の
イベント ログ関数 を