PFN_WER_RUNTIME_EXCEPTION_DEBUGGER_LAUNCH回呼函式 (werapi.h)
Windows 錯誤報告 (WER) 呼叫此函式，讓您自訂偵錯工具啟動選項和啟動字串。
PFN_WER_RUNTIME_EXCEPTION_DEBUGGER_LAUNCH類型會定義這個回呼函式的指標。 您必須使用 「OutOfProcessExceptionEventDebuggerLaunchCallback」 作為回呼函式的名稱。
語法
PFN_WER_RUNTIME_EXCEPTION_DEBUGGER_LAUNCH PfnWerRuntimeExceptionDebuggerLaunch;
HRESULT PfnWerRuntimeExceptionDebuggerLaunch(
[in] PVOID pContext,
[in] const PWER_RUNTIME_EXCEPTION_INFORMATION pExceptionInformation,
[out] PBOOL pbIsCustomDebugger,
[out] PWSTR pwszDebuggerLaunch,
[in, out] PDWORD pchDebuggerLaunch,
[out] PBOOL pbIsDebuggerAutolaunch
)
{...}
參數
[in] pContext
當您呼叫 WerRegisterRuntimeExceptionModule 函式來註冊例外狀況處理常式時所指定的任意內容資訊的指標。
[in] pExceptionInformation
包含例外狀況資訊的 WER_RUNTIME_EXCEPTION_INFORMATION 結構。
[out] pbIsCustomDebugger
如果使用pwszDebuggerLaunch參數中指定的自訂偵錯工具來偵錯損毀，請將 設定為TRUE;否則，請將 設定為FALSE以使用預設偵錯工具。 如果您將此參數設定為 FALSE，請勿設定 pwszDebuggerLaunch 參數。
[out] pwszDebuggerLaunch
呼叫端配置的緩衝區，用來指定用來啟動偵錯工具的偵錯工具啟動字串。 啟動字串必須包含偵錯工具的完整路徑和任何引數。 如果引數包含多個單字，請使用引號來分隔引數。 偵錯工具字串應該遵守與預設 AeDebug 偵錯工具字串相同的通訊協定， (請參閱 設定自動 偵錯) 。 字串必須包含兩個格式規範：當機進程識別碼的 %ld，以及自訂偵錯工具附加至目標 (之後要發出事件物件的控制碼，以取得這些規範的描述，請參閱 啟用事後偵 錯) 。 不過，自訂偵錯工具可以選擇忽略這些參數。
[in, out] pchDebuggerLaunch
pwszDebuggerLaunch緩衝區的大小，以字元為單位。
[out] pbIsDebuggerAutolaunch
如果您想要 WER 以無訊息方式啟動偵錯工具，請將 設定為 TRUE ;否則，如果您想要 WER 在啟動偵錯工具之前要求使用者，則為 FALSE 。
傳回值
傳回 S_OK，即使未使用任何客戶偵錯工具也一樣。 如果您傳回其他失敗碼，WER 會還原為其預設損毀報告行為。
備註
您必須在例外狀況處理常式 DLL 中實作此函式。
WER 會使用此函式來判斷要啟動的偵錯工具，以及是否要自動啟動偵錯工具，或在啟動偵錯工具之前詢問使用者。 指定自訂偵錯工具會覆寫預設啟動字串， (AeDebug 登錄機碼包含預設啟動字串) 。
只有當您將OutOfProcessExceptionEventCallback 回呼函式的pbOwnershipClaimed參數設定為TRUE時，WER 才會呼叫此回呼函式。
規格需求
| 最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 R2 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | werapi.h |