IDebugSymbols3::GetModuleByModuleName2Wide 方法 (dbgeng.h)
GetModuleByModuleName2Wide 方法會搜尋進程的模組,尋找具有指定名稱的模組。
語法
HRESULT GetModuleByModuleName2Wide(
[in] PCWSTR Name,
[in] ULONG StartIndex,
[in] ULONG Flags,
[out, optional] PULONG Index,
[out, optional] PULONG64 Base
);
參數
[in] Name
指定所需模組的名稱。
[in] StartIndex
指定要開始搜尋的索引。
[in] Flags
指定位集合,其中包含搜尋具有指定名稱的模組時所使用的選項。 旗標 可能包含下列位旗標:
旗標 | 效果 |
---|---|
DEBUG_GETMOD_NO_LOADED_MODULES | 請勿搜尋載入的模組。 |
DEBUG_GETMOD_NO_UNLOADED_MODULES | 請勿搜尋卸除的模組。 |
[out, optional] Index
接收名稱為 Name 的第一個模組索引。 如果 Index 為 NULL,則不會傳回此資訊。
[out, optional] Base
接收模組基底之目標記憶體位址空間中的位置。 如果 Base 為 NULL,則不會傳回這項資訊。
傳回值
這個方法也可能傳回其他錯誤值。 如需詳細資訊,請參閱 傳回值 。
傳回碼 | 描述 |
---|---|
|
此方法成功。 |
|
傳入的其中一個自變數無效。 |
備註
從指定的索引開始,這些方法會傳回使用指定名稱尋找的第一個模組。 如果目標有多個模組具有此名稱,則可以重複呼叫這些方法,找到具有較高值 StartIndex 的後續模組。
如需模組的詳細資訊,請參閱 模組。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | dbgeng.h (包含 Dbgeng.h) |