PFN_WER_RUNTIME_EXCEPTION_EVENT_SIGNATURE回呼函式 (werapi.h)
Windows 錯誤報告 (WER) 呼叫此函式,以取得唯一描述問題的報表參數。
PFN_WER_RUNTIME_EXCEPTION_EVENT_SIGNATURE類型會定義這個回呼函式的指標。 您必須使用 「OutOfProcessExceptionEventSignatureCallback」 作為回呼函式的名稱。
語法
PFN_WER_RUNTIME_EXCEPTION_EVENT_SIGNATURE PfnWerRuntimeExceptionEventSignature;
HRESULT PfnWerRuntimeExceptionEventSignature(
[in] PVOID pContext,
[in] const PWER_RUNTIME_EXCEPTION_INFORMATION pExceptionInformation,
[in] DWORD dwIndex,
[out] PWSTR pwszName,
[in, out] PDWORD pchName,
[out] PWSTR pwszValue,
[in, out] PDWORD pchValue
)
{...}
參數
[in] pContext
當您呼叫 WerRegisterRuntimeExceptionModule 函式來註冊例外狀況處理程式時所指定的任意內容資訊的指標。
[in] pExceptionInformation
包含例外狀況資訊的 WER_RUNTIME_EXCEPTION_INFORMATION 結構。
[in] dwIndex
報表參數的索引。 有效值為 0 到 9。 對這個函式的第一次呼叫必須將索引設定為0,而且每個連續呼叫必須循序遞增索引值。
[out] pwszName
您用來指定參數名稱的呼叫端配置緩衝區。
[in, out] pchName
pwszName 緩衝區的大小,以字元為單位。 大小包含 Null 終止字元。
[out] pwszValue
您用來指定參數值的呼叫端配置緩衝區。
[in, out] pchValue
pwszValue 緩衝區的大小,以字元為單位。 大小包含 Null 終止字元。
傳回值
在成功時傳回 S_OK 。 如果您傳回其他失敗碼,WER 會還原為其預設損毀報告行為。
備註
您必須在例外狀況處理程式 DLL 中實作此函式。
若要產生應用程式特定問題的錯誤報告,應用程式必須使用一些稱為報表參數的基本資訊來建立問題的簡短描述。 報表參數包含應用程式名稱、應用程式版本、模組名稱、模組版本和錯誤碼等資訊。 這些報表參數的組合描述唯一的問題。
只有當您將 OutOfProcessExceptionEventCallback 回呼函式的 pbOwnershipClaimed 參數設定為 TRUE 時,WER 才會呼叫此回呼函式。 OutOfProcessExceptionEventCallback 的 pdwSignatureCount 參數決定 WER 將呼叫此回呼函式的次數。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 R2 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | werapi.h |