Freigeben über


RoResolveRestrictedErrorInfoReference-Funktion (roerrorapi.h)

Gibt den IRestrictedErrorInfo-Schnittstellenzeiger basierend auf dem angegebenen Verweis zurück.

Syntax

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

Parameter

[in] reference

Typ: PCWSTR

Identifiziert ein Fehlerobjekt, das relevante Informationen für den spezifischen Fehler enthält.

[out] ppRestrictedErrorInfo

Typ: IRestrictedErrorInfo**

Der Ausgabeparameter für das Objekt, das dem angegebenen Verweis zugeordnet ist.

Rückgabewert

Typ: HRESULT

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
Der Vorgang wurde erfolgreich ausgeführt.
CLASS_E_NOAGGREGATION
-Objekt unterstützt keine Aggregation.
E_INVALIDARG
Der Verweis ist ungültig.

Hinweise

Die RoResolveRestrictedErrorInfoReference-Funktion ist in erster Linie für die Debuggerentwicklung nützlich. Ein Debugger empfängt die Verweiszeichenfolge und verwendet den Verweis, um das zugeordnete IRestrictedErrorInfo-Objekt zu identifizieren, wodurch der Debugger die detaillierte Fehlermeldung durch Aufrufen der GetErrorDetails-Methode abrufen kann.

Beispiele

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;

}

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8
Unterstützte Mindestversion (Server) Windows Server 2012
Zielplattform Windows
Kopfzeile roerrorapi.h
Bibliothek Runtimeobject.lib