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 |