ICorDebugModule3::CreateReaderForInMemorySymbols メソッド

  • [アーティクル]

動的モジュールのデバッグ シンボル リーダーを作成します。

構文

HRESULT CreateReaderForInMemorySymbols (  
      [in] REFIID riid,  
      [out][iid_is(riid)] void **    ppObj

パラメーター

riid
[入力] 返す COM インターフェイスの IID。 通常、これは ISymUnmanagedReader インターフェイスです。

ppObj
[出力] 返されたインターフェイスへのポインターをさらに指し示すポインター。

戻り値

S_OK
リーダーが正常に作成されました。

CORDBG_E_MODULE_LOADED_FROM_DISK
モジュールはインメモリ モジュールでも動的モジュールでもありません。

CORDBG_E_SYMBOLS_NOT_AVAILABLE
シンボルはアプリケーションによって提供されていないか、まだ利用できません。

E_FAIL (またはその他の E_ リターン コード)
リーダーを作成できません。

解説

このメソッドを使用し、インメモリ (非動的) モジュールのシンボル リーダー オブジェクトを作成できますが、シンボルがまず作成された後になります (UpdateModuleSymbols Method コールバックで示されます)。

このメソッドは呼び出されるたびに新しいリーダー インスタンスを返します (CComPtrBase::CoCreateInstance など)。 そのため、デバッガーでは、結果をキャッシュし、基礎データが変更された可能性があるときにのみ (つまり、LoadClass Method コールバックが受信されたとき)、新しいインスタンスを要求するようにしてください。

最初の型が読み込まれるまで (LoadClass Method コールバックで示されます)、動的モジュールでは、いかなるシンボルも利用できません。

必要条件

:「システム要件」を参照してください。

ヘッダー: CorDebug.idl、CorDebug.h

ライブラリ: CorGuids.lib

.NET Framework のバージョン: 4.5、4、3.5 SP1

関連項目