RaiseFailFastException 函式 (errhandlingapi.h)

  • 發行項

引發例外狀況，略過框架或向量型) (所有例外狀況處理程式。 引發此例外狀況會終止應用程式，並在啟用 Windows 錯誤報告 時叫用 Windows 錯誤報告。

語法

void RaiseFailFastException(
  [in, optional] PEXCEPTION_RECORD pExceptionRecord,
  [in, optional] PCONTEXT          pContextRecord,
  [in]           DWORD             dwFlags
);

參數

[in, optional] pExceptionRecord

包含例外狀況資訊的 EXCEPTION_RECORD 結構的指標。 您必須指定 ExceptionAddress 和 ExceptionCode 成員。

如果此參數為 NULL，函式會建立例外狀況記錄，並將 ExceptionCode 成員設定為 STATUS_FAIL_FAST_EXCEPTION。 如果 dwFlags 參數包含 FAIL_FAST_GENERATE_EXCEPTION_ADDRESS 旗標，函式也會設定 ExceptionAddress 成員。

[in, optional] pContextRecord

包含內容資訊的 CONTEXT 結構的指標。 如果 為 NULL，此函式會產生內容 (，但內容不會完全符合呼叫端的內容) 。

[in] dwFlags

您可以指定零或下列旗標來控制此函式的行為：

值 意義
FAIL_FAST_GENERATE_EXCEPTION_ADDRESS
0x1
 導致 RaiseFailFastException 將 EXCEPTION_RECORD的 ExceptionAddress 設定為此函式的傳回位址， (呼叫者呼叫 RaiseFailFastException) 之後的下一個指令。 只有當 ExceptionAddress 不是 NULL 時，此函式才會設定例外狀況位址。

傳回值

無

備註

一般而言，如果您的應用程式處於不良狀態，而且您想要立即終止應用程式，並已建立 Windows 錯誤報告，則呼叫此函式。

如果 WER 服務已停用或無法啟動，或沒有附加至進程的調試程式，則會終止進程。

此函式會引發第二個機率例外狀況。 如果已啟用 JIT 偵錯，調試程式會附加至進程。

規格需求

需求 值
最低支援的用戶端 Windows 7 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 errhandlingapi.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

Environment.FailFast