IDebugSymbols2::GetModuleNameString メソッド (dbgeng.h)

GetModuleNameString メソッドは、指定したモジュールの名前を返します。

構文

HRESULT GetModuleNameString(
  [in]            ULONG   Which,
  [in]            ULONG   Index,
  [in]            ULONG64 Base,
  [out, optional] PSTR    Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  NameSize
);

パラメーター

[in] Which

返すモジュールの名前を指定します。使用可能な値は次のとおりです。

値	説明
DEBUG_MODNAME_IMAGE	画像の名前。 これは、拡張子を含む実行可能ファイルの名前です。 通常、フル パスはユーザー モードに含まれますが、カーネル モードには含まれません。
DEBUG_MODNAME_MODULE	モジュール名。 通常、これは拡張子のないファイル名です。 場合によっては、モジュール名がファイル名と大きく異なります。
DEBUG_MODNAME_LOADED_IMAGE	読み込まれたイメージ名。 Microsoft CodeView シンボルが存在しない限り、これはイメージ名と同じです。
DEBUG_MODNAME_SYMBOL_FILE	シンボル ファイル名。 シンボル ファイルのパスと名前。 シンボルが読み込まれていない場合は、代わりに実行可能ファイルの名前になります。
DEBUG_MODNAME_MAPPED_IMAGE	マップされたイメージ名。 ほとんどの場合、これは NULL です。 デバッガーがイメージ ファイルをマッピングしている場合 (ミニダンプ デバッグ中など)、これはマップされたイメージの名前です。

[in] Index

モジュールのインデックスを指定します。 DEBUG_ANY_IDに設定されている場合は、 Base パラメーターを使用してモジュールの場所を指定します。

[in] Base

Index がDEBUG_ANY_IDの場合は、モジュールのベースのターゲットのメモリ アドレス空間内の場所を指定します。 それ以外の場合は無視されます。

[out, optional] Buffer

モジュールの名前を受け取ります。 Buffer が NULL の場合、この情報は返されません。

[in] BufferSize

バッファー バッファーのサイズを文字数で指定 します。 このサイズには、'\0' 終端文字のスペースが含まれます。

[out, optional] NameSize

モジュールの名前の文字でサイズを受け取ります。 このサイズには、'\0' 終端文字のスペースが含まれます。 NameSize が NULL の場合、この情報は返されません。

戻り値

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

リターン コード	説明
S_OK	メソッドは正常に実行されました。
S_FALSE	メソッドは正常に実行されました。 ただし、バッファーのサイズはモジュールの名前のサイズよりも小さかったため、バッファーに収まるように切り捨てられました。

注釈

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

要件

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

こちらもご覧ください

GetModuleNames

IDebugSymbols2

IDebugSymbols3