通过

GetModuleHandleExW 函数 （libloaderapi.h）

  • 项目

检索指定模块的模块句柄，并递增模块的引用计数，除非指定了GET_MODULE_HANDLE_EX_FLAG_UNCHANGED_REFCOUNT。 该模块必须由调用进程加载。

语法

BOOL GetModuleHandleExW(
  [in]           DWORD   dwFlags,
  [in, optional] LPCWSTR lpModuleName,
  [out]          HMODULE *phModule
);

参数

[in] dwFlags

此参数可以是零个或以下一个或多个值。 如果模块的引用计数递增，调用方必须使用 FreeLibrary 函数在不再需要模块句柄时递减引用计数。

GET_MODULE_HANDLE_EX_FLAG_FROM_ADDRESS（0x00000004）

lpModuleName 参数是模块中的地址。

GET_MODULE_HANDLE_EX_FLAG_PIN（0x00000001）

无论调用 FreeLibrary 多少次，模块都会一直加载到进程终止。

此选项不能用于GET_MODULE_HANDLE_EX_FLAG_UNCHANGED_REFCOUNT。

GET_MODULE_HANDLE_EX_FLAG_UNCHANGED_REFCOUNT（0x00000002）

模块的引用计数不会递增。 此选项等效于 GetModuleHandle的行为。 不要将检索到的模块句柄传递给 FreeLibrary 函数;这样做可能会导致 DLL 过早地取消映射。 有关详细信息，请参阅“备注”。

此选项不能用于GET_MODULE_HANDLE_EX_FLAG_PIN。

[in, optional] lpModuleName

加载的模块的名称（.dll 或 .exe 文件），或模块中的地址（如果 dwFlags GET_MODULE_HANDLE_EX_FLAG_FROM_ADDRESS）。

对于模块名称，如果省略文件扩展名，则会追加默认库扩展名 .dll。 文件名字符串可以包含尾随点字符 （.），以指示模块名称没有扩展名。 该字符串不必指定路径。 指定路径时，请务必使用反斜杠（\），而不是正斜杠（/）。 名称与当前映射到调用进程的地址空间的模块的名称进行比较（大小写）。

如果此参数为 NULL，则该函数将返回用于创建调用进程的文件的句柄（.exe 文件）。

[out] phModule

指定模块的句柄。 如果函数失败，则此参数 NULL。

GetModuleHandleEx 函数不会检索使用 LOAD_LIBRARY_AS_DATAFILE 标志加载的模块的句柄。 有关详细信息，请参阅 LoadLibraryEx。

返回值

如果函数成功，则返回值为非零。

如果函数失败，则返回值为零。 若要获取扩展的错误信息，请参阅 GetLastError。

言论

返回的句柄不是全局的或可继承的。 它不能由另一个进程复制或使用。

如果 lpModuleName 不包含路径，并且有多个加载的模块具有相同基名称和扩展，则无法预测将返回哪个模块句柄。 若要解决此问题，可以指定路径、使用 并行程序集，或指定内存位置，而不是 lpModuleName 参数中的 DLL 名称。

如果 dwFlags 包含GET_MODULE_HANDLE_EX_FLAG_UNCHANGED_REFCOUNT，则 GetModuleHandleEx 函数返回映射模块的句柄，而不递增其引用计数。 但是，如果此句柄传递给 FreeLibrary 函数，则映射模块的引用计数将递减。 因此，不要将 GetModuleHandleEx 返回的句柄 GET_MODULE_HANDLE_EX_FLAG_UNCHANGED_REFCOUNT传递给 FreeLibrary 函数。 这样做可能会导致 DLL 模块过早地取消映射。

如果 dwFlags 包含GET_MODULE_HANDLE_EX_FLAG_UNCHANGED_REFCOUNT，则必须在多线程应用程序中仔细使用此函数。 不能保证模块句柄在函数返回句柄和使用句柄的时间之间保持有效。 例如，线程检索模块句柄，但在使用句柄之前，第二个线程释放该模块。 如果系统加载另一个模块，它可以重复使用最近释放的模块句柄。 因此，第一个线程的句柄与预期模块不同。

若要编译使用此函数的应用程序，请将_WIN32_WINNT定义为0x0501或更高版本。 有关详细信息，请参阅 使用 Windows 标头。

注意

libloaderapi.h 标头将 GetModuleHandleEx 定义为基于 UNICODE 预处理器常量定义自动选择此函数的 ANSI 或 Unicode 版本的别名。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows XP [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 libloaderapi.h （包括 Windows.h）
库 Kernel32.lib
DLL Kernel32.dll

另请参阅

Dynamic-Link 库函数

FreeLibrary

GetModuleFileName

LoadLibrary

LoadLibraryEx

VBS enclave 中提供的 Vertdll API