lookupIconIdFromDirectory 函数 (winuser.h)

项目
03/04/2024

搜索图标 (RT_GROUP_ICON) 或光标 (RT_GROUP_CURSOR 最适合当前显示设备的图标或光标) 资源数据。

若要指定所需的高度或宽度，请使用 LookupIconIdFromDirectoryEx 函数。此函数通过在 cxDesiredcyDesired/ 参数中传递零来调用它。

语法

int LookupIconIdFromDirectory(
  [in] PBYTE presbits,
  [in] BOOL  fIcon
);

参数

[in] presbits

类型： PBYTE

图标或游标目录数据。由于此函数不验证资源数据，因此它会导致常规保护 (GP) 故障，或者如果 presbits 未指向有效的资源数据，则返回未定义的值。

[in] fIcon

类型： BOOL

指示是寻求图标还是游标。如果此参数为 TRUE，则函数将搜索图标;如果参数为 FALSE，则表示函数正在搜索游标。

返回值

类型： int

如果函数成功，则返回值是最适合当前显示设备的图标 (RT_ICON) 或游标 (RT_CURSOR) 的整数资源标识符。

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

注解

类型为 RT_GROUP_ICON (RT_GROUP_CURSOR 的资源文件指示游标) 包含图标 (或游标) 多种与设备无关的格式的数据。 LookupIconIdFromDirectory 在资源文件中搜索最适合当前显示设备的图标 (或光标) ，并返回其整数标识符。 FindResource 和 FindResourceEx 函数使用此标识符的 MAKEINTRESOURCE 宏来查找模块中的资源。

图标目录是从资源文件中加载的，其资源类型 RT_GROUP_ICON 游标) (或 RT_GROUP_CURSOR ，以及要加载的特定图标的整数资源名称。 LookupIconIdFromDirectory 返回一个整数标识符，该标识符是最适合当前显示设备的图标的资源名称。

LoadIcon、LoadCursor 和 LoadImage 函数使用此函数在指定的资源数据中搜索最适合当前显示设备的图标或光标。

要求

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