LoadBitmapW 函数 （winuser.h）
[LoadBitmap 可用于“要求”部分中指定的操作系统。 在后续版本中可能会更改或不可用。 请改用 LoadImage 和 DrawFrameControl.]
LoadBitmap 函数从模块的可执行文件加载指定的位图资源。
语法
HBITMAP LoadBitmapW(
[in] HINSTANCE hInstance,
[in] LPCWSTR lpBitmapName
);
参数
[in] hInstance
模块实例的句柄，其可执行文件包含要加载的位图。
[in] lpBitmapName
指向以 null 结尾的字符串的指针，该字符串包含要加载的位图资源的名称。 或者，此参数可以包含低序单词中的资源标识符和高序单词中的零。 MAKEINTRESOURCE 宏可用于创建此值。
返回值
如果函数成功，则返回值是指定位图的句柄。
如果函数失败，则返回值 NULL。
言论
如果 lpBitmapName 参数指向的位图不存在或内存不足无法加载位图，则函数将失败。
LoadBitmap 创建显示器的兼容位图，该位图无法选择打印机。 若要加载可以选择到打印机的位图，请调用 LoadImage 并指定LR_CREATEDIBSECTION来创建 DIB 节。 可以将 DIB 部分选为任何设备。
应用程序可以使用 LoadBitmap 函数来访问预定义的位图。 为此，应用程序必须将 hInstance 参数设置为 NULL，并将 lpBitmapName 参数设置为以下值之一。
| 位图名称 | 位图名称 |
|---|---|
| OBM_BTNCORNERS | OBM_OLD_RESTORE |
| OBM_BTSIZE | OBM_OLD_RGARROW |
| OBM_CHECK | OBM_OLD_UPARROW |
| OBM_CHECKBOXES | OBM_OLD_ZOOM |
| OBM_CLOSE | OBM_REDUCE |
| OBM_COMBO | OBM_REDUCED |
| OBM_DNARROW | OBM_RESTORE |
| OBM_DNARROWD | OBM_RESTORED |
| OBM_DNARROWI | OBM_RGARROW |
| OBM_LFARROW | OBM_RGARROWD |
| OBM_LFARROWD | OBM_RGARROWI |
| OBM_LFARROWI | OBM_SIZE |
| OBM_MNARROW | OBM_UPARROW |
| OBM_OLD_CLOSE | OBM_UPARROWD |
| OBM_OLD_DNARROW | OBM_UPARROWI |
| OBM_OLD_LFARROW | OBM_ZOOM |
| OBM_OLD_REDUCE | OBM_ZOOMD |
以OBM_OLD开头的位图名称表示 Windows 早于 3.0 的 16 位版本的位图。
若要使应用程序使用任何OBM_常量，必须在包含 Windows.h 头文件之前定义常量 OEMRESOURCE。
应用程序必须调用 DeleteObject 函数来删除 LoadBitmap 函数返回的每个位图句柄。
例子
有关示例，请参阅 使用菜单中的 Menu-Item 位图示例。
注意
winuser.h 标头将 LoadBitmap 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 支持的最低服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | 窗户 |
| 标头 | winuser.h （包括 Windows.h） |
| 库 | User32.lib |
| DLL | User32.dll |
| API 集 | ext-ms-win-ntuser-draw-l1-1-1（在 Windows 8.1 中引入） |