PFN_WER_RUNTIME_EXCEPTION_EVENT回呼函式 (werapi.h)

Windows 錯誤報告 (WER) 呼叫此函式，以判斷例外狀況處理程式是否宣告當機。

PFN_WER_RUNTIME_EXCEPTION_EVENT類型會定義這個回呼函式的指標。 您必須使用 「OutOfProcessExceptionEventCallback」 作為回呼函式的名稱。

語法

PFN_WER_RUNTIME_EXCEPTION_EVENT PfnWerRuntimeExceptionEvent;

HRESULT PfnWerRuntimeExceptionEvent(
  [in]      PVOID pContext,
  [in]      const PWER_RUNTIME_EXCEPTION_INFORMATION pExceptionInformation,
  [out]     BOOL *pbOwnershipClaimed,
  [out]     PWSTR pwszEventName,
  [in, out] PDWORD pchSize,
  [out]     PDWORD pdwSignatureCount
)
{...}

參數

[in] pContext

當您呼叫 WerRegisterRuntimeExceptionModule 函式以註冊例外狀況處理程式時所指定的任意內容資訊的指標。

[in] pExceptionInformation

包含例外狀況資訊的WER_RUNTIME_EXCEPTION_INFORMATION結構。 使用信息來判斷您是否要宣告當機。

[out] pbOwnershipClaimed

如果例外狀況處理程式宣告此當機，則設定為 TRUE ;否則為 FALSE。 如果您將此參數設定為 FALSE，請勿設定其餘的 out 參數。

[out] pwszEventName

呼叫端配置的緩衝區，可用來指定用來識別此當機的事件名稱。

[in, out] pchSize

pwszEventName 緩衝區的大小，以字元為單位。 緩衝區限制為MAX_PATH個字元。 大小包含 Null 終止字元。

[out] pdwSignatureCount

您將提供的報表參數數目。 值的有效範圍是一到 10。 如果您指定大於 10 的值，WER 將會忽略該值，並只收集前 10 個參數。 如果您指定零，則報告程式將會不確定。

這個值會決定 WER 呼叫 OutOfProcessExceptionEventSignatureCallback 函式的次數。

傳回值

傳回 S_OK，即使例外狀況處理程式未宣告此損毀也一樣。 如果您傳回其他失敗碼，如果未註冊其他處理程式，WER 會還原為其默認損毀報告行為。

備註

您必須在例外狀況處理程式 DLL 中實作此函式。

規格需求

需求	值
最低支援的用戶端	Windows 7 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2 [僅限桌面應用程式]
目標平台	Windows
標頭	werapi.h

另請參閱

WerRegisterRuntimeExceptionModule， Windows 錯誤報告