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

另请参阅

概念性

参考