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

[アーティクル]
02/23/2024

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

モジュールのモジュール名を受け取ります。 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	指定したモジュールが見つかりませんでした。