ILanguageExceptionStackBackTrace

プロジェクションが例外に対して独自のスタックトレースを提供できるようにします。

関連する Global Error Handler API でスタックトレースを取得できない場合、言語プロジェクションではこのインターフェイスを実装することを推奨します。

例

次の例は、言語例外オブジェクトに実装したインターフェイスを通じて、プロジェクションがバックトレースを提供する方法を示しています。Global Error Handling (GEH) は、言語例外オブジェクトが RoOriginateLanguageException または CapturePropagationContext に渡されたときに、このインターフェイスを照会します。これにより、GEH 自身ではバックトレースを取得できないプロジェクションについても、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; 
    } 
} 

スタックのバックトレースを取得します。

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

Global Error Handler の機能でバックトレースを取得できない場合は、言語プロジェクションで GetStackBackTrace を実装してください。GetStackBackTrace は、RoOriginateLanguageException エクスポートおよび CapturePropagationContext が、渡された言語例外がこのインターフェイスを実装していることをインターフェイスの照会 (QI) によって検出したときに呼び出されます。