GetModuleHandleW 函数 （libloaderapi.h）
检索指定模块的模块句柄。 该模块必须由调用进程加载。
若要避免“备注”部分中所述的争用条件，请使用 GetModuleHandleEx 函数。
语法
HMODULE GetModuleHandleW(
[in, optional] LPCWSTR 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 [仅限桌面应用] |
| 目标平台 | 窗户 |
| 标头 | libloaderapi.h （包括 Windows.h） |
| 库 | Kernel32.lib |
| DLL | Kernel32.dll |