ILanguageExceptionErrorInfo2

ILanguageExceptionErrorInfo と同様に、言語プロジェクションがエラー情報を提供および取得できるようにします。さらに、言語の境界をまたいで動作するという利点があります。

1 つ前の言語例外エラー情報オブジェクトを取得します。

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

一般的には、対象の例外に関する追加のエラー情報を保持する IRestrictedErrorInfo オブジェクトの連結リストを取得するために GetPropagationContextHead を使用します。その後、GetPreviousLanguageExceptionErrorInfo を使用してその連結リストをたどり、各エラーを個別に調べることができます。

オペレーティングシステムも、このメソッドを使用してエラーに関連付けられた保存済みの例外 (stowed exception) を取得します。

言語の境界およびスレッドをまたいで、例外のコンテキストをキャプチャします。

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

CapturePropagationContext は、言語プロジェクションがエラーを再スローする際に使用されます。これには、言語の境界でエラーを受け取った場合も含まれます。そのため、CapturePropagationContext を使用することで、現在の再スローに対する例外のバックトレースが確実にキャプチャされます。これは、例外が言語の境界を越える際に、関連するデバッグ情報が失われないようにするためでもあります。

一般的に、このメソッドは、例外がどのように伝播したかに関する追加のエラー情報を提供する IRestrictedErrorInfo オブジェクトの連結リストを作成します。この情報は、クラッシュダンプ解析時に例外レコードから参照される保存済みの例外 (stowed exception) として公開されます。この連結リストを使用すると、例外が伝播したすべての言語境界とスレッドのバックトレース (エラーの発生元を含む) を確認できます。

例

次の例は、プロジェクションが自身の言語境界において、別のプロジェクションまたは WRL からエラーを受け取る様子を示しています。これは既存のシナリオですが、前のプロジェクションが追加のコンテキストをキャプチャできなかった場合でも、システムがそれをキャプチャできるようにします。

HRESULT CreateFooExceptionFromLanguageBoundaryError(HRESULT errorReceived, IFooException** createdException)
{
    HRESULT hr = S_OK;
    ComPtr<IFooException> exception;
    // 現在のエラーを取得する
    ComPtr<IRestrictedErrorInfo> restrictedErrorInfo;
    *createdException = nullptr;
    if (SUCCEEDED(GetRestrictedErrorInfo(&restrictedErrorInfo)))
    {
        // エラーの詳細を取得し、それが古い (stale) エラーなのか、
        // それとも境界で受け取ったエラーなのかを判断する。
        BSTR description;
        HRESULT errorOriginated;
        BSTR restrictedDescription;
        BSTR capabilitySid;
        hr = restrictedErrorInfo->GetErrorDetails(
            &description,
            &errorOriginated,
            &restrictedDescription,
            &capabilitySid);
        if (SUCCEEDED(hr) && errorReceived == errorOriginated)
        {
            hr = CreateFooException(
                errorOriginated,
                restrictedDescription,
                restrictedErrorInfo.Get(),
                &exception);
            // 新しいインターフェイスをクエリし、現在の伝播コンテキストを
            // キャプチャするためのロジックが存在するかどうかを確認する。
            ComPtr<ILanguageExceptionErrorInfo2> languageExceptionErrorInfo;
            if (SUCCEEDED(restrictedErrorInfo.As(&languageExceptionErrorInfo)))
            {
                languageExceptionErrorInfo->CapturePropagationContext(nullptr);
            }		
            *createdException = exception.Detach();
            SetRestrictedErrorInfo(restrictedErrorInfo.Get());
            SysFreeString(description);
            SysFreeString(restrictedDescription);
            SysFreeString(capabilitySid);
            return hr;
        }
        SysFreeString(description);
        SysFreeString(restrictedDescription);
        SysFreeString(capabilitySid);
    }

    // エラーが一致しなかった場合、またはエラーの詳細を取得できなかった場合はここに到達する。
    // その場合は新しいエラーを発生 (originate) させる。
    // OriginateErrorInfoForThrow は RoOriginateLanguageException を呼び出し、
    // それによってコンテキストがキャプチャされる。
    hr = CreateFooException(errorReceived, nullptr, nullptr, &exception);
    if(SUCCEEDED(hr))
    {
        exception->OriginateErrorInfoForThrow();
        *createdException = exception.Detach();
    }
    return hr;
}

伝播コンテキストの先頭を取得します。

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

GetPropagationContextHead を使用すると、対象の例外に関する追加のエラー情報を保持する IRestrictedErrorInfo オブジェクトの連結リストを取得できます。その後、GetPreviousLanguageExceptionErrorInfo を使用してその連結リストをたどり、各エラーを個別に調べることができます。

オペレーティングシステムも、このメソッドを使用してエラーに関連付けられた保存済みの例外 (stowed exception) を取得します。