Función RoResolveRestrictedErrorInfoReference (roerrorapi.h)

Devuelve el puntero de interfaz IRestrictedErrorInfo basado en la referencia especificada.

Sintaxis

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

Parámetros

[in] reference

Tipo: PCWSTR

Identifica un objeto de error que contiene información relevante para el error específico.

[out] ppRestrictedErrorInfo

Tipo: IRestrictedErrorInfo**

Parámetro de salida del objeto asociado a la referencia especificada.

Valor devuelto

Tipo: HRESULT

Esta función puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	La operación se realizó correctamente.
CLASS_E_NOAGGREGATION	object no admite la agregación.
E_INVALIDARG	La referencia no es válida.

Comentarios

La función RoResolveRestrictedErrorInfoReference es útil principalmente para el desarrollo del depurador. Un depurador recibe la cadena de referencia y usa la referencia para identificar el objeto IRestrictedErrorInfo asociado, que permite al depurador recuperar el mensaje de error detallado llamando al método GetErrorDetails .

Ejemplos

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;

}

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8
Servidor mínimo compatible	Windows Server 2012
Plataforma de destino	Windows
Encabezado	roerrorapi.h
Library	Runtimeobject.lib