ILanguageExceptionStackBackTrace-Schnittstelle (restrictederrorinfo.h)

Artikel
03/04/2024

Ermöglicht Projektionen das Bereitstellen einer benutzerdefinierten Stapelablaufverfolgung für diese Ausnahme.

Vererbung

Die ILanguageExceptionStackBackTrace-Schnittstelle erbt von der IUnknown-Schnittstelle . ILanguageExceptionStackBackTrace verfügt auch über die folgenden Membertypen:

Methoden

Die ILanguageExceptionStackBackTrace-Schnittstelle verfügt über diese Methoden.


ILanguageExceptionStackBackTrace::GetStackBackTrace Ruft die Rückstapelablaufverfolgung ab.

Hinweise

Es wird empfohlen, diese Schnittstelle von Sprachprojektionen zu implementieren, wenn die Stapelablaufverfolgung nicht von der relevanten api für globale Fehlerhandler erfasst wird.

Beispiele

Im folgenden Beispiel wird eine Projektion veranschaulicht, die ihre Rückverfolgung über eine Schnittstelle bereitstellt, die für das Sprach-Ausnahmeobjekt implementiert ist. Global Error Handling (GEH)-Abfragen für diese Schnittstelle, wenn ein Sprachausnahmeobjekt für RoOriginateLanguageException oder CapturePropagationContext bereitgestellt wird. Daher ermöglicht dieses Szenario dem GEH, Rückverfolgungen für Projektionen verfügbar zu machen, für die das GEH keine Rückverfolgungen erfassen kann.

class FooExceptionInfo : public Microsoft::WRL::RuntimeClass< 
    Microsoft::WRL::RuntimeClassFlags< 
    Microsoft::WRL::RuntimeClassType::ClassicCom>, 
    ... 
    ILanguageExceptionStackBackTrace > 
{ 
    ... 
    ... 
private: 
    UINT_PTR* customBackTrace; 
    int numFramesCaptured; 
public: 
    HRESULT GetStackBackTrace( 
        ULONG maxFramesToCapture, 
        UINT_PTR stackBackTrace [], 
        ULONG* framesCaptured) 
    { 
        int idx = 0; 
        for (; idx < maxFramesToCapture && idx < numFramesCaptured; idx++) 
        { 
            stackBackTrace[idx] = customBackTrace[idx]; 
        } 
        *framesCaptured = idx; 
        return S_OK; 
    } 
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1703 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	restrictederrorinfo.h

Siehe auch

IUnknown

Freigeben über