Fonction RoResolveRestrictedErrorInfoReference (roerrorapi.h)

Retourne le pointeur d’interface IRestrictedErrorInfo en fonction de la référence donnée.

Syntaxe

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

Paramètres

[in] reference

Type : PCWSTR

Identifie un objet d’erreur qui contient des informations pertinentes pour l’erreur spécifique.

[out] ppRestrictedErrorInfo

Type : IRestrictedErrorInfo**

Paramètre de sortie de l’objet associé à la référence donnée.

Valeur retournée

Type : HRESULT

Cette fonction peut retourner l’une de ces valeurs.

Remarques

La fonction RoResolveRestrictedErrorInfoReference est principalement utile pour le développement du débogueur. Un débogueur reçoit la chaîne de référence et utilise la référence pour identifier l’objet IRestrictedErrorInfo associé, ce qui permet au débogueur de récupérer le message d’erreur détaillé en appelant la méthode GetErrorDetails .

Exemples

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;

}

Configuration requise