(dbgeng.h) IDebugSymbols2：：GetModuleNames 方法

發行項
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 對對應的名稱而言太小，因此已截斷。
E_NOINTERFACE	找不到指定的模組。