次の方法で共有

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

  • [アーティクル]

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

構文

HRESULT GetModuleNames(
  [in]            ULONG   Index,
  [in]            ULONG64 Base,
  [out, optional] PSTR    ImageNameBuffer,
  [in]            ULONG   ImageNameBufferSize,
  [out, optional] PULONG  ImageNameSize,
  [out, optional] PSTR    ModuleNameBuffer,
  [in]            ULONG   ModuleNameBufferSize,
  [out, optional] PULONG  ModuleNameSize,
  [out, optional] PSTR    LoadedImageNameBuffer,
  [in]            ULONG   LoadedImageNameBufferSize,
  [out, optional] PULONG  LoadedImageNameSize
);

パラメーター

[in] Index

名前が要求されるモジュールのインデックスを指定します。 DEBUG_ANY_IDに設定されている場合、モジュールは Baseで指定されます。

[in] Base

名前が要求されるモジュールのベース アドレスを指定します。 このパラメーターは、Index が DEBUG_ANY_ID に設定されている場合にのみ使用されます。

[out, optional] ImageNameBuffer

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

[in] ImageNameBufferSize

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

[out, optional] ImageNameSize

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

[out, optional] ModuleNameBuffer

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

[in] ModuleNameBufferSize

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

[out, optional] ModuleNameSize

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

[out, optional] LoadedImageNameBuffer

モジュールの読み込まれたイメージ名を受け取ります。 LoadedImageNameBuffer が NULL 場合、この情報は返されません。

[in] LoadedImageNameBufferSize

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

[out, optional] LoadedImageNameSize

読み込まれたイメージ名のサイズを文字数で受け取ります。 このサイズには、'\0' 終端文字のスペースが含まれます。 LoadedImageNameSize NULL 場合、この情報は返されません。

戻り値

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

リターン コード 形容
S_OK
 メソッドが成功しました。
S_FALSE
 メソッドが成功しました。 ただし、ImageNameBuffer、ModuleNameBuffer、または LoadedImageNameBuffer の 少なくとも 1 つが、対応する名前に対して小さすぎたため、切り捨てられました。
E_NOINTERFACE
 指定したモジュールが見つかりませんでした。

備考

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

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー dbgeng.h (Dbgeng.h を含む)

関連項目

GetModuleNameString の

IDebugSymbols

IDebugSymbols2 を する

IDebugSymbols3