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 |