Interface ILanguageExceptionStackBackTrace (restrictederrorinfo.h)

Permite que as projeções forneçam rastreamento de pilha personalizado para essa exceção.

Herança

A interface ILanguageExceptionStackBackTrace herda da interface IUnknown . ILanguageExceptionStackBackTrace também tem estes tipos de membros:

Métodos

A interface ILanguageExceptionStackBackTrace tem esses métodos.

ILanguageExceptionStackBackTrace::GetStackBackTrace Recupera o rastreamento de pilha de fundo.

Comentários

É recomendável que as projeções de linguagem implementem essa interface quando o rastreamento de pilha não for capturado pela API do Manipulador de Erros Global relevante.

Exemplos

O exemplo a seguir demonstra uma projeção que fornece seu rastreamento de fundo por meio de uma interface implementada no objeto de exceção de linguagem. Consultas GEH (Tratamento Global de Erros) para essa interface quando um objeto de exceção de linguagem é fornecido a RoOriginateLanguageException ou CapturePropagationContext. Dessa forma, esse cenário permite que o GEH exponha rastreamentos de volta para projeções para as quais o GEH não pode capturar rastreamentos de volta.

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10, versão 1703 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2016 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	restrictederrorinfo.h

Confira também

IUnknown