Interface ILanguageExceptionStackBackTrace (restrictederrorinfo.h)
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 |