共用方式為

IDebugSymbols3：：GetModuleNameStringWide 方法 (dbgeng.h)

  • 發行項

GetModuleNameStringWide 方法會傳回指定模組的名稱。

語法

HRESULT GetModuleNameStringWide(
  [in]            ULONG   Which,
  [in]            ULONG   Index,
  [in]            ULONG64 Base,
  [out, optional] PWSTR   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

IDebugSymbols3