LoadCursorA 函数 (winuser.h)

项目
08/27/2023

从与应用程序实例关联的可执行文件 (.EXE) 文件中加载指定的游标资源。

注意

此函数已被 LoadImage 函数 (取代，) 设置了 LR_DEFAULTSIZE 和 LR_SHARED 标志。

语法

HCURSOR LoadCursorA(
  [in, optional] HINSTANCE hInstance,
  [in]           LPCSTR    lpCursorName
);

参数

[in, optional] hInstance

类型： HINSTANCE

DLL 或可执行文件 (.exe 模块的句柄，) 包含要加载的游标的文件。有关详细信息，请参阅 GetModuleHandle。

若要加载预定义的系统游标，请将此参数设置为 NULL。

[in] lpCursorName

类型： LPCTSTR

如果 hInstance 为非 NULL， 则 lpCursorName 按名称或序号指定游标资源。必须使用 MAKEINTRESOURCE 宏打包此序号。

如果 hInstance 为 NULL， 则 lpCursorName 将指定标识符 (从要加载的预定义系统游标的 IDC_前缀) 开始。

返回值

类型： HCURSOR

如果函数成功，则返回值是新加载的游标的句柄。

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

注解

仅当游标资源尚未加载时， LoadCursor 函数才会加载游标资源;否则，它将检索现有资源的句柄。仅当 lpCursorName 参数是指向游标资源的指针时，此函数才返回有效的游标句柄。如果 lpCursorName 是指向除游标 (（例如图标) ）以外的任何类型的资源的指针，则返回值不是 NULL，即使它不是有效的游标句柄也是如此。

LoadCursor 函数搜索最适合当前显示设备的游标资源。光标资源可以是颜色位图或单色位图。

DPI 虚拟化

此 API 不参与 DPI 虚拟化。返回的输出不受调用线程的 DPI 影响。

示例

有关示例，请参阅创建游标。

注意

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

要求


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