ReportEventW

指定したイベントログの末尾にエントリを書き込む。(Unicode)

ReportEventW hEventLog, wType, wCategory, dwEventID, lpUserSid, wNumStrings, dwDataSize, lpStrings, lpRawData

hEventLog : [intptr] イベントログへのハンドル。RegisterEventSource 関数がこのハンドルを返す。Windows XP SP2 以降、このパラメータは Security ログへのハンドルにできない。Security ログにイベントを書き込むには、AuthzReportSecurityEvent 関数を使用する。
wType : [int] 
wCategory : [int] イベントカテゴリ。これはソース固有の情報で、カテゴリは任意の値にできる。詳細はイベントカテゴリを参照のこと。
dwEventID : [int] イベント識別子。イベント識別子はイベントソースに関連付けられたメッセージファイル内のエントリを指定する。詳細はイベント識別子を参照のこと。
lpUserSid : [int] 現在のユーザのセキュリティ識別子へのポインタ。セキュリティ識別子が不要な場合、このパラメータは NULL にできる。
wNumStrings : [int] lpStrings パラメータが指す配列内の挿入文字列の数。値 0 は文字列が存在しないことを示す。
dwDataSize : [int] ログに書き込むイベント固有の生 (バイナリ) データのバイト数。このパラメータが 0 の場合、イベント固有のデータは存在しない。
lpStrings : [var] イベントビューアがユーザに文字列を表示する前にメッセージにマージされる、null 終端文字列の配列を含むバッファへのポインタ。このパラメータは、wNumStrings が 0 であっても有効なポインタ(または NULL)でなければならない。各文字列は 31,839 文字までに制限される。Windows Vista より前: 各文字列は 32K 文字までに制限される。
lpRawData : [intptr] バイナリデータを含むバッファへのポインタ。このパラメータは、dwDataSize パラメータが 0 であっても有効なポインタ(または NULL)でなければならない。

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

解説

指定したイベントログの末尾にエントリを書き込む。(Unicode)

[戻り値]
関数が成功した場合、戻り値は 0 以外となり、エントリがログに書き込まれたことを示す。
関数が失敗した場合、戻り値は 0 となる。拡張エラー情報を取得するには GetLastError
を呼び出す。以下の拡張エラーコードのいずれかが返される。
(以下省略)

[備考]
この関数はイベントを記録するために使用する。エントリは hEventLog
パラメータで識別されるソース用に構成されたログの末尾に書き込まれる。ReportEvent
関数は、エントリをログに格納する前に時刻、エントリの長さ、オフセットを追加する。関数がユーザ名を追加できるようにするには、lpUserSid
パラメータにユーザの SID
を指定する必要がある。記録できるメッセージデータのサイズ制限は、アプリケーションを実行するクライアントとメッセージが記録されるサーバの
Windows バージョンに応じて異なる。サーバは RegisterEventSource 関数に渡される lpUNCServerName
パラメータによって決定される。サイズ制限を超えた場合、Windows のバージョンに応じて異なるエラーが返される。ログに記録する文字列に

情報

プラグイン / モジュール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