共用方式為

IDebugSymbols3：：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

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

價值 描述
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

如果 索引 是DEBUG_ANY_ID，則指定目標記憶體位址空間中模組基底的位置。 否則會忽略它。

[out, optional] Buffer

接收模組的名稱。 如果 緩衝區NULL，則不會傳回此資訊。

[in] BufferSize

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

[out, optional] NameSize

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

傳回值

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

傳回碼 描述
S_OK
 方法成功。
S_FALSE
 方法成功。 不過，緩衝區的大小小於模組名稱的大小，因此會截斷以符合緩衝區。

言論

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

要求

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

另請參閱

GetModuleNames

IDebugSymbols2

IDebugSymbols3