RoResolveRestrictedErrorInfoReference 関数 (roerrorapi.h)

指定された参照に基づいて IRestrictedErrorInfo インターフェイス ポインターを返します。

構文

HRESULT RoResolveRestrictedErrorInfoReference(
  [in]  PCWSTR               reference,
  [out] IRestrictedErrorInfo **ppRestrictedErrorInfo
);

パラメーター

[in] reference

種類: PCWSTR

特定のエラーに関連する情報を含むエラー オブジェクトを識別します。

[out] ppRestrictedErrorInfo

種類: IRestrictedErrorInfo**

指定された参照に関連付けられているオブジェクトの出力パラメーター。

戻り値

種類: HRESULT

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

リターン コード	説明
S_OK	操作が成功しました。
CLASS_E_NOAGGREGATION	オブジェクトは集計をサポートしていません。
E_INVALIDARG	参照が無効です。

注釈

RoResolveRestrictedErrorInfoReference 関数は、主にデバッガー開発に役立ちます。 デバッガーは参照文字列を受け取り、参照を使用して関連付けられている IRestrictedErrorInfo オブジェクトを識別します。これにより、デバッガーは GetErrorDetails メソッドを呼び出して詳細なエラー メッセージを取得できます。

例

HRESULT DebuggerIntegration(PCWST   referenceName)
{
    HRESULT hr = S_OK;
    IRestrictedErrorInfo *pRORestrictedErrorInfo = nullptr;

    // Resolve the IRestrictedErrorInfo
    hr = RoResolveRestrictedErrorInfoReference(referenceName,  
                      reinterpret_cast<void**>(&pRORestrictedErrorInfo));
    if (FAILED(hr))
    {
        hr = E_FAIL;
    }


    HRESULT hrError = S_OK;
    BSTR bstrDescription = nullptr;
    BSTR bstrRestrictedDescription = nullptr;

    // Get the error details out of the interface
    if (SUCCEEDED(hr))
    {
        hr = spRestrictedErrorInfo->GetErrorDetails(&bstrDescription,
                                      &hrError, &bstrRestrictedDescription);
        if (FAILED(hr))
        {
            hr = E_FAIL;
        }
    }

   return hr;

}

要件

要件	値
サポートされている最小のクライアント	Windows 8
サポートされている最小のサーバー	Windows Server 2012
対象プラットフォーム	Windows
ヘッダー	roerrorapi.h
Library	Runtimeobject.lib