Compartilhar via


Função RoResolveRestrictedErrorInfoReference (roerrorapi.h)

Retorna o ponteiro da interface IRestrictedErrorInfo com base na referência fornecida.

Sintaxe

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

Parâmetros

[in] reference

Tipo: PCWSTR

Identifica um objeto de erro que contém informações relevantes para o erro específico.

[out] ppRestrictedErrorInfo

Tipo: IRestrictedErrorInfo**

O parâmetro de saída do objeto associado à referência fornecida.

Retornar valor

Tipo: HRESULT

Essa função pode retornar um desses valores.

Código de retorno Descrição
S_OK
A operação foi realizada com êxito.
CLASS_E_NOAGGREGATION
O objeto não dá suporte à agregação.
E_INVALIDARG
A referência é inválida.

Comentários

A função RoResolveRestrictedErrorInfoReference é útil principalmente para o desenvolvimento do depurador. Um depurador recebe a cadeia de caracteres de referência e usa a referência para identificar o objeto IRestrictedErrorInfo associado, que permite que o depurador recupere a mensagem de erro detalhada chamando o método GetErrorDetails .

Exemplos

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 Valor
Cliente mínimo com suporte Windows 8
Servidor mínimo com suporte Windows Server 2012
Plataforma de Destino Windows
Cabeçalho roerrorapi.h
Biblioteca Runtimeobject.lib