RoResolveRestrictedErrorInfoReference-Funktion (roerrorapi.h)

Artikel
03/04/2024

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

Freigeben über