Функция 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
Header roerrorapi.h
Библиотека Runtimeobject.lib