共用方式為

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

接收模組的映像名稱。 如果 ImageNameBufferNULL，則不會傳回此資訊。

[in] ImageNameBufferSize

指定緩衝區的大小，ImageNameBuffer 字元。 此大小包含 『\0』 終止字元的空間。

[out, optional] ImageNameSize

接收影像名稱的字元大小。 此大小包含 『\0』 終止字元的空間。 如果 ImageNameSizeNULL，則不會傳回此資訊。

[out, optional] ModuleNameBuffer

接收模組的模組名稱。 此大小包含 『\0』 終止字元的空間。 如果 ModuleNameBufferNULL，則不會傳回此資訊。

[in] ModuleNameBufferSize

指定緩衝區的大小，ModuleNameBuffer。 此大小包含 『\0』 終止字元的空間。

[out, optional] ModuleNameSize

接收模組名稱的字元大小。 此大小包含 『\0』 終止字元的空間。 如果 ModuleNameSizeNULL，則不會傳回此資訊。

[out, optional] LoadedImageNameBuffer

接收已載入的模組映像名稱。 如果 LoadedImageNameBufferNULL，則不會傳回此資訊。

[in] LoadedImageNameBufferSize

指定緩衝區的大小，LoadedImageNameBuffer。 此大小包含 『\0』 終止字元的空間。

[out, optional] LoadedImageNameSize

接收已載入映像名稱的字元大小。 此大小包含 『\0』 終止字元的空間。 如果 LoadedImageNameSizeNULL，則不會傳回此資訊。

傳回值

這個方法也可能傳回其他錯誤值。 如需詳細資訊，請參閱 傳回值。

傳回碼 描述
S_OK
 方法成功。
S_FALSE
 方法成功。 不過，至少有一個 ImageNameBuffer、ModuleNameBuffer或 LoadedImageNameBuffer 對對應名稱而言太小，因此已截斷。
E_NOINTERFACE
 找不到指定的模組。

言論

如需模組的詳細資訊，請參閱 Modules。

要求

要求 價值
目標平臺 桌面
標頭 dbgeng.h （include Dbgeng.h）

另請參閱

GetModuleNameString

IDebugSymbols

IDebugSymbols2

IDebugSymbols3