GetModuleHandleA 函数 (libloaderapi.h)

检索指定模块的模块句柄。 该模块必须由调用进程加载。

若要避免“备注”部分中所述的争用条件,请使用 GetModuleHandleEx 函数。

语法

HMODULE GetModuleHandleA(
  [in, optional] LPCSTR lpModuleName
);

参数

[in, optional] lpModuleName

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

如果此参数为 NULL, GetModuleHandle 将返回用于创建调用进程 (.exe 文件) 的文件的句柄。

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

返回值

如果函数成功,则返回值是指定模块的句柄。

如果函数失败,则返回值为 NULL。 要获得更多的错误信息,请调用 GetLastError。

注解

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

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

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

此函数必须在多线程应用程序中小心使用。 不能保证模块句柄在函数返回句柄和使用句柄的时间之间保持有效。 例如,假设线程检索模块句柄,但在使用句柄之前,第二个线程释放模块。 如果系统加载另一个模块,它可以重复使用最近释放的模块句柄。 因此,第一个线程将具有与预期模块不同的模块的句柄。

示例

有关示例,请参阅 使用画笔

注意

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

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 libloaderapi.h (包括 Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

另请参阅

动态链接库函数

FreeLibrary

GetModuleFileName

GetModuleHandleEx

LoadLibrary

LoadLibraryEx