ILanguageExceptionTransform

別の例外をキャッチした catch ハンドラーのコンテキストからスローされた例外について、そのすべてのコンテキスト情報を言語プロジェクションがシステムに提供できるようにします。

変換された制限付きエラー情報 (restricted error info) を取得します。

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

GetTransformedRestrictedErrorInfo は通常、例外が持つすべてのコンテキスト情報をシステムに公開するために言語プロジェクションによって実装されます。具体的には、別の例外をキャッチした catch ハンドラーのコンテキストからスローされた例外の情報を公開します。スローされた例外は、キャッチされた例外の「変換 (transformation)」と見なされ、一部のプロジェクションでは内部例外 (inner exception) とも見なされます。これにより、開発者は変換前の元の例外がなぜ発生したのかを把握できます。

実装されている場合、システムは GetTransformedRestrictedErrorInfo の呼び出しによって取得した IRestrictedErrorInfo を使用して、IRestrictedErrorInfo オブジェクトのもう 1 つの連結リストを作成します。これらのオブジェクトは、CapturePropagationContext でキャプチャされた伝播 (propagation) の格納例外 (stowed exception) と並んで、クラッシュダンプ内に格納例外として公開されます。他の例外と同様に、変換リスト内のこれらのオブジェクトは GetPreviousLanguageExceptionErrorInfo を使用してたどり、アクセスできます。

例

[ 
    uuid(7974CD8B-A9EF-4CC4-9A7D-5793CCE30734), 
    pointer_default(unique), 
    object 
] 
interface IFooExceptionInfo : IUnknown 
{ 
    ... 
    HRESULT SetTranformedException(IFooException* exception); 
} 

class FooExceptionInfo : public Microsoft::WRL::RuntimeClass< 
    Microsoft::WRL::RuntimeClassFlags< 
    Microsoft::WRL::RuntimeClassType::ClassicCom>, 
    IFooExceptionInfo, 
    ILanguageExceptionTransform> 
{ 
    ... 
    ... 
private: 
    HRESULT _hr; 
    Microsoft::WRL::Wrappers::HString _message; 
    ComPtr<IFooException> _transformedException; 
public: 
    HRESULT SetTranformedException(IFooException* exception) 
    { 
        _transformedException = exception; 
        return S_OK; 
    } 

    HRESULT GetTransformedRestrictedErrorInfo(IRestrictedErrorInfo** restrictedErrorInfo) 
    { 
        return _transformedException->GetRestrictedErrorForException( 
                   restrictedErrorInfo); 
    } 
} 
[ 
    uuid(52394734-6600-4835-8E17-60BDEDB14B81), 
    pointer_default(unique), 
    object 
] 
interface IFooException : IUnknown 
{ 
    ... 
    HRESULT GetRestrictedErrorForException(IRestrictedErrorInfo** restrictedErrorInfo); 
    HRESULT GetExceptionInfo(IFooExceptionInfo** exceptionInfo); 
} 

class FooException : public Microsoft::WRL::RuntimeClass< 
    Microsoft::WRL::RuntimeClassFlags< 
    Microsoft::WRL::RuntimeClassType::ClassicCom>, 
    IFooException 
    ...> 
{ 
    ... 
    ... 
private: 
    ComPtr<IFooExceptionInfo> _exceptionInfo; 
    ComPtr<IRestrictedErrorInfo> _restrictedErrorInfo;  
public: 
    HRESULT GetRestrictedErrorForException(IRestrictedErrorInfo** restrictedErrorInfo) 
    { 
        return _restrictedErrorInfo.CopyTo(restrictedErrorInfo); 
    } 

    HRESULT GetExceptionInfo(IFooExceptionInfo** exceptionInfo) 
    { 
        return _exceptionInfo.CopyTo(exceptionInfo); 
    } 
} 
void OriginateErrorInfoForThrowWithCaughtException(IFooException* exception, IFooException* caughtException) 
{ 
    ComPtr<IFooExceptionInfo> exceptionInfo;     if(SUCCEEDED(exception->GetExceptionInfo(&exceptionInfo))) 
    { 
        exceptionInfo->SetTranformedException(caughtException); 
        exception->OriginateErrorInfoForThrow(); 
    } 
}