ClearEventLogW

指定したイベントログをクリアし、任意でログの現在のコピーをバックアップファイルに保存する。(Unicode)

ClearEventLogW hEventLog, lpBackupFileName

hEventLog : [intptr] クリアするイベントログへのハンドル。OpenEventLog 関数はこのハンドルを返す。
lpBackupFileName : [wstr] バックアップファイルの絶対パスまたは相対パス。このファイルが既に存在する場合、関数は失敗する。

(プラグイン / モジュール : advapi32.dll)

解説

指定したイベントログをクリアし、任意でログの現在のコピーをバックアップファイルに保存する。(Unicode)

[戻り値]
関数が成功した場合、戻り値は 0 以外となる。関数が失敗した場合、戻り値は 0 となる。拡張エラー情報を取得するには
GetLastError を呼び出す。イベントログが空であるかバックアップファイルが既に存在する場合、ClearEventLog
関数は失敗することがある。

[備考]
本関数の復帰後、クリアされたイベントログを参照するハンドルはログの読み取りに使用できない。
> [!NOTE] > winbase.h ヘッダは、ClearEventLog を UNICODE プリプロセッサ定数の定義に基づいて
ANSI 版または Unicode
版を自動選択するエイリアスとして定義している。エンコーディング中立のエイリアスとエンコーディング中立でないコードを混在させると、コンパイルエラーや実行時エラーを引き起こす不一致が生じる可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報