イベント ログの操作

OpenEventLog、OpenBackupEventLog、RegisterEventSource、DeregisterEventSource、および CloseEventLog関数イベント ログ ハンドルを開いたり閉じたりします。

次の表に、開いているイベント ログに対して実行できる操作と、各操作の対応する関数を示します。

OpenEventLog および ReportEvent関数は、リモート サーバーで操作を実行できるように、オプションのサーバー名をパラメーターとして受け取ります。 OpenEventLog を使用して、ログの管理操作 (バックアップ、クリア、監視、クエリ) を読み取ったり実行したり、RegisterEventSource を使用してログに書き込みます。

イベント ログ関数の各呼び出しはアトミック操作です。 イベント ログから読み取ると、イベント レコード全体のみが返されます。 イベント ログに書き込む場合、各イベント レコードはログ内の完全なレコードとして順番に書き込まれるように保証されます。 次の一覧では、イベント ログ サービスが特別な条件を処理する方法について説明します。

• イベント ログ サービスは、読み取り操作と書き込み操作を同時に受け取ります。読み取り位置がファイルの末尾にある場合は、読み取り操作が "ファイルの終了" 状態で失敗するか (書き込み操作が完了していない場合)、または新しいレコードを返します (書き込み操作が完了した場合)。
• イベント ログ サービスは、読み取り操作を受け取る前にクリア操作を完了します。読み取り操作は"ファイルの終了" 状態で失敗します。
• イベント ログ サービスは、書き込み操作を受け取る前にクリア操作を完了します。クリア操作ではログが切り捨てられ、書き込み操作によってログの先頭に新しいレコードが追加されます。