SaferRecordEventLogEntry 関数 (winsafer.h)

  • [アーティクル]

SaferRecordEventLogEntry 関数は、メッセージをイベント ログに保存します。

構文

BOOL SaferRecordEventLogEntry(
  [in] SAFER_LEVEL_HANDLE hLevel,
  [in] LPCWSTR            szTargetPath,
       LPVOID             lpReserved
);

パラメーター

[in] hLevel

イベント ログに送信するルールの詳細を含むSAFER_LEVEL_HANDLE。

[in] szTargetPath

実行しようとしたファイルのパス。

lpReserved

将来利用するために予約されています。 このパラメーターは NULL に設定する必要があります。

戻り値

関数が成功した場合は TRUE。それ以外の場合は FALSE。 拡張エラー情報については、 GetLastError を呼び出します。

解説

SaferIdentifyLevel が、SAFER_LEVELID_FULLYTRUSTED (0x40000) 以外の LevelId を持つSAFER_LEVEL_HANDLEを返す場合は、トラブルシューティングを容易にするために SaferRecordEventLogEntry を呼び出すことができます。 たとえば、excel.exe のボタンをクリックすると、完全に信頼されていない別のプロセスを起動しようとする場合があります。 プログラムが CreateProcess から返されたエラーを再マップしたため、あいまいなエラー メッセージが表示されることがあります。 トラブルシューティングを容易にするために、一部の Safer 関数は SaferRecordEventLogEntry を呼び出してイベント ログにイベントを送信します。

要件

   
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー winsafer.h
Library Advapi32.lib
[DLL] Advapi32.dll
API セット ext-ms-win-advapi32-safer-l1-1-0 (Windows 8 で導入)