BackupEventLogW

指定したイベントログをバックアップファイルに保存する。(Unicode)

BackupEventLogW hEventLog, lpBackupFileName

hEventLog : [intptr] 開いているイベントログへのハンドル。OpenEventLog 関数はこのハンドルを返す。
lpBackupFileName : [wstr] バックアップファイルの絶対パスまたは相対パス。

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

解説

指定したイベントログをバックアップファイルに保存する。(Unicode)

[戻り値]
関数が成功した場合、戻り値は 0 以外となる。
関数が失敗した場合、戻り値は 0 となる。拡張エラー情報を取得するには GetLastError を呼び出す。

[備考]
ユーザーが SE_BACKUP_NAME 特権を持っていない場合、BackupEventLog 関数は
ERROR_PRIVILEGE_NOT_HELD エラーで失敗する。
> [!NOTE] > winbase.h ヘッダは、BackupEventLog を UNICODE プリプロセッサ定数の定義に基づいて
ANSI 版または Unicode
版を自動選択するエイリアスとして定義している。エンコーディング中立のエイリアスとエンコーディング中立でないコードを混在させると、コンパイルエラーや実行時エラーを引き起こす不一致が生じる可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報

プラグイン / モジュールadvapi32.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の advapi32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_advapi32_gen2.hs