GetRestrictedErrorInfo 函式 (roerrorapi.h)
取得目前邏輯線程中 SetRestrictedErrorInfo 先前呼叫所設定的受限制錯誤信息物件。
語法
HRESULT GetRestrictedErrorInfo(
[out] IRestrictedErrorInfo **ppRestrictedErrorInfo
);
參數
[out] ppRestrictedErrorInfo
與目前線程相關聯的受限制錯誤信息物件。
傳回值
此函式可以傳回下列其中一個值。
| 傳回碼 | 描述 |
|---|---|
|
已成功擷取受限制的錯誤物件。 |
|
沒有與目前線程相關聯的受限制錯誤物件。 任何其他錯誤對象都會從線程中移除。 |
備註
呼叫 GetRestrictedErrorInfo 函式，以取得 Windows 市集應用程式中目前線程上最近設定的 IRestrictedErrorInfo 物件。
呼叫 RoCaptureErrorContext 函式，以儲存目前線程的錯誤資訊。 呼叫 RoFailFastWithErrorContext 函式以引發例外狀況、終止目前的進程，並將錯誤回報給 Windows 錯誤報告 服務， (WER) 。
GetRestrictedErrorInfo 會將錯誤對象的擁有權轉移給呼叫端，並清除線程的錯誤狀態。 如果最近設定的錯誤物件不支援 IRestrictedErrorInfo 介面，則會清除線程的錯誤狀態，但不會將介面傳回給呼叫端。
GetRestrictedErrorInfo 會從目前的線程擷取錯誤物件，並呼叫 QueryInterface 來尋找 IRestrictedErrorInfo 介面。 如果找不到 IRestrictedErrorInfo，GetRestrictedErrorInfo 會傳回S_FALSE。 在此情況下，錯誤物件會從線程中移除。 如需詳細資訊，請參閱 GetErrorInfo。
如果 IRestrictedErrorInfo 不是系統實作，則呼叫 GetRestrictedErrorInfo 函式會失敗。 若要建立 IRestrictedErrorInfo 物件，請呼叫 OriginateError、 TransformError 或 RoCaptureErrorContext 函式。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2012 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | roerrorapi.h |
| Dll | Combase.dll |