GetRestrictedErrorInfo 関数 (roerrorapi.h)

現在の論理スレッドで SetRestrictedErrorInfo を前回呼び出した場合に設定された制限付きエラー情報オブジェクトを取得します。

構文

HRESULT GetRestrictedErrorInfo(
  [out] IRestrictedErrorInfo **ppRestrictedErrorInfo
);

パラメーター

[out] ppRestrictedErrorInfo

現在のスレッドに関連付けられている制限付きエラー情報オブジェクト。

戻り値

この関数は、これらの値のいずれかを返すことができます。

リターンコード	Description
S_OK	制限付きエラーオブジェクトが正常に取得されました。
S_FALSE	現在のスレッドに関連付けられている制限付きエラーオブジェクトはありません。その他のエラーオブジェクトはスレッドから削除されます。

注釈

GetRestrictedErrorInfo 関数を呼び出して、Windows ストアアプリの現在のスレッドで最近設定された IRestrictedErrorInfo オブジェクトを取得します。

RoCaptureErrorContext 関数を呼び出して、現在のスレッドのエラー情報を保存します。 RoFailFastWithErrorContext 関数を呼び出して例外を発生させ、現在のプロセスを終了し、エラーを Windows エラー報告サービス (WER) に報告します。

GetRestrictedErrorInfo は、エラーオブジェクトの所有権を呼び出し元に転送し、スレッドのエラー状態をクリアします。最近設定されたエラーオブジェクトが IRestrictedErrorInfo インターフェイスをサポートしていない場合、スレッドのエラー状態はクリアされますが、インターフェイスは呼び出し元に返されません。

GetRestrictedErrorInfo は、現在のスレッドからエラーオブジェクトを取得し、QueryInterface を呼び出して IRestrictedErrorInfo インターフェイスを検索します。 IRestrictedErrorInfo が見つからない場合、GetRestrictedErrorInfo はS_FALSEを返します。この場合、エラーオブジェクトはスレッドから削除されます。詳細については、「 GetErrorInfo」を参照してください。

IRestrictedErrorInfo がシステム実装でない場合、GetRestrictedErrorInfo 関数の呼び出しは失敗します。 IRestrictedErrorInfo オブジェクトを作成するには、OriginateError、TransformError、または RoCaptureErrorContext 関数を呼び出します。

Requirements

Requirement	価値
サポートされる最小クライアント	Windows 8 [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップアプリ \|UWP アプリ]
ターゲットプラットフォームの	ウィンドウズ
Header	roerrorapi.h
Library	mincore.lib
DLL	Combase.dll