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