Interface ILanguageExceptionStackBackTrace (restrictederrorinfo.h)

  • Article

Permet aux projections de fournir une trace de pile personnalisée pour cette exception.

Héritage

L’interface ILanguageExceptionStackBackTrace hérite de l’interface IUnknown. ILanguageExceptionStackBackTrace a également les types de membres suivants :

Méthodes

L’interface ILanguageExceptionStackBackTrace a ces méthodes.

 
ILanguageExceptionStackBackTrace ::GetStackBackTrace

Récupère la trace de la pile arrière.

Remarques

Il est recommandé que les projections de langage implémentent cette interface lorsque la trace de pile n’est pas capturée par l’API gestionnaire d’erreurs globale appropriée.

Exemples

L’exemple suivant illustre une projection fournissant sa trace arrière via une interface implémentée sur l’objet d’exception de langage. Requêtes GEH (Global Error Handling) pour cette interface lorsqu’un objet d’exception de langage est fourni à RoOriginateLanguageException ou CapturePropagationContext. Par conséquent, ce scénario permet au GEH d’exposer des traces en arrière pour les projections pour lesquelles le GEH ne peut pas capturer les traces arrière.

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

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 1703 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2016 (applications de bureau uniquement)
Plateforme cible Windows
En-tête restrictederrorinfo.h

Voir aussi

IUnknown