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

另請參閱

WerRegisterRuntimeExceptionModule， Windows 錯誤報告