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

指定要傳回的模組名稱，可能的值為：

值	Description
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	此方法成功。 不過，緩衝區的大小小於模組名稱的大小，因此會截斷以符合緩衝區。

備註

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

規格需求

需求	值
目標平台	桌面
標頭	dbgeng.h (包含 Dbgeng.h)

另請參閱

GetModuleNames

IDebugSymbols2

IDebugSymbols3