RoResolveRestrictedErrorInfoReference function (roerrorapi.h)

Returns the IRestrictedErrorInfo interface pointer based on the given reference.

Syntax

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

Parameters

[in] reference

Type: PCWSTR

Identifies an error object which contains relevant information for the specific error.

[out] ppRestrictedErrorInfo

Type: IRestrictedErrorInfo**

The output parameter for the object associated with the given reference.

Return value

Type: HRESULT

This function can return one of these values.

Remarks

The RoResolveRestrictedErrorInfoReference function is useful primarily for debugger development. A debugger receives the reference string and uses the reference to identify the associated IRestrictedErrorInfo object, which allows the debugger to retrieve the detailed error message by calling the GetErrorDetails method.

Examples

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;

}

Requirements