IDebugSymbols3::AddSyntheticModule メソッド (dbgeng.h)

AddSyntheticModule メソッドは、デバッガーが現在のプロセス用に保持するモジュール一覧に合成モジュールを追加します。

構文

HRESULT AddSyntheticModule(
  [in] ULONG64 Base,
  [in] ULONG   Size,
  [in] PCSTR   ImagePath,
  [in] PCSTR   ModuleName,
  [in] ULONG   Flags
);

[in] Base

合成モジュールのベースのプロセスの仮想アドレス空間内の場所を指定します。

[in] Size

合成モジュールのサイズをバイト単位で指定します。

[in] ImagePath

合成モジュールのイメージ名を指定します。これは、合成モジュールの実行可能ファイルの名前として返される名前です。完全なパスは、既知の場合は含める必要があります。

[in] ModuleName

合成モジュールのモジュール名を指定します。

[in] Flags

DEBUG_ADDSYNTHMOD_DEFAULTに設定します。

リターンコード	説明
S_OK	メソッドは正常に実行されました。

このメソッドは、エラー値を返す場合もあります。詳細については、「戻り値」を参照してください。

Base パラメーターと Size パラメーターで記述される合成モジュールのメモリ領域は、他のモジュールのメモリ領域と重複してはなりません。

すべてのモジュールが再読み込みされた場合 (たとえば、Module パラメーターを空の文字列に設定して Reload を呼び出すと)、すべての合成モジュールが破棄されます。

合成モジュールの詳細については、「合成モジュール」を参照してください。

要件	値
対象プラットフォーム	デスクトップ
Header	dbgeng.h (Dbgeng.h を含む)