Interfaccia ILanguageExceptionStackBackTrace (restrictederrorinfo.h)

Articolo
08/25/2023

Consente alle proiezioni di fornire analisi dello stack personalizzata per tale eccezione.

Ereditarietà

L'interfaccia ILanguageExceptionStackBackTrace eredita dall'interfaccia IUnknown . ILanguageExceptionStackBackTrace include anche questi tipi di membri:

Metodi

L'interfaccia ILanguageExceptionStackBackTrace include questi metodi.


ILanguageExceptionStackBackTrace::GetStackBackTrace Recupera l'analisi dello stack indietro.

Commenti

È consigliabile che le proiezioni del linguaggio implementino questa interfaccia quando l'analisi dello stack non viene acquisita dall'API del gestore errori globale pertinente.

Esempio

Nell'esempio seguente viene illustrata una proiezione che fornisce la traccia indietro tramite un'interfaccia implementata nell'oggetto eccezione del linguaggio. Query GEH (Global Error Handling) per questa interfaccia quando viene fornito un oggetto eccezione di linguaggio a RoOriginateLanguageException o CapturePropagationContext. Di conseguenza, questo scenario consente a GEH di esporre le tracce indietro per le proiezioni per cui GEH non può acquisire tracce indietro.

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; 
    } 
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 versione 1703 [solo app desktop]
Server minimo supportato	Windows Server 2016 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	restrictederrorinfo.h

Vedi anche

IUnknown

Condividi tramite