Antarmuka ILanguageExceptionStackBackTrace (restrictederrorinfo.h)

  • Artikel

Memungkinkan proyeksi untuk menyediakan jejak tumpukan kustom untuk pengecualian tersebut.

Warisan

Antarmuka ILanguageExceptionStackBackTrace mewarisi dari antarmuka IUnknown . ILanguageExceptionStackBackTrace juga memiliki jenis anggota berikut:

Metode

Antarmuka ILanguageExceptionStackBackTrace memiliki metode ini.

 
ILanguageExceptionStackBackTrace::GetStackBackTrace

Mengambil jejak tumpukan belakang.

Keterangan

Disarankan agar proyeksi bahasa mengimplementasikan antarmuka ini ketika pelacakan tumpukan tidak ditangkap oleh API Handler Kesalahan Global yang relevan.

Contoh

Contoh berikut menunjukkan proyeksi yang menyediakan jejak belakangnya melalui antarmuka yang diimplementasikan pada objek pengecualian bahasa. Kueri Global Error Handling (GEH) untuk antarmuka ini ketika objek pengecualian bahasa disediakan untuk RoOriginateLanguageException atau CapturePropagationContext. Dengan demikian, skenario ini memungkinkan GEH untuk mengekspos kembali jejak untuk proyeksi yang tidak dapat diambil kembali jejak GEH.

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

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10, versi 1703 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2016 [hanya aplikasi desktop]
Target Platform Windows
Header restrictederrorinfo.h

Lihat juga

IUnknown