LockResource 函数 (libloaderapi.h)
检索指向内存中指定资源的指针。
语法
LPVOID LockResource(
[in] HGLOBAL hResData
);
parameters
[in] hResData
类型: HGLOBAL
要访问的资源的句柄。 LoadResource 函数返回此句柄。 请注意,此参数作为 HGLOBAL 变量列出,只是为了向后兼容。 不要将任何值作为参数传递,而不是 LoadResource 函数的成功返回值。
返回值
类型: LPVOID
如果加载的资源可用,则返回值是指向资源第一个字节的指针;否则为 NULL。
注解
LockResource 返回的指针在卸载包含资源的模块之前有效。 无需解锁资源,因为当创建资源的进程终止时,系统会自动将其删除。
请勿尝试使用 FindResourceA 函数或 FindResourceExA 函数返回的句柄来锁定资源。 此类句柄指向随机数据。
注意
LockResource 实际上不会锁定内存;它仅用于获取指向包含资源数据的内存的指针。 函数的名称来自 Windows XP 之前的版本,当时它用于锁定 LoadResource 分配的全局内存块。
示例
有关示例,请参阅 更新资源。
要求
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | libloaderapi.h (包括 Windows.h) |
Library | Kernel32.lib |
DLL | Kernel32.dll |