WcsEnumColorProfiles 函数 (icm.h)

  • 项目

枚举与指定范围内任何设备关联的颜色配置文件。

注意

此 API 不支持 HDR 监视器的“高级颜色”配置文件。 使用 ColorProfileGetDisplayList 管理高级颜色配置文件。

语法

BOOL WcsEnumColorProfiles(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PENUMTYPEW                   pEnumRecord,
  PBYTE                        pBuffer,
  DWORD                        dwSize,
  PDWORD                       pnProfiles
);

parameters

scope

一个WCS_PROFILE_MANAGEMENT_SCOPE值，该值指定此配置文件管理操作的范围。

pEnumRecord

指向指定枚举条件的结构的指针。

pBuffer

指向要枚举配置文件名称的缓冲区的指针。 WcsEnumColorProfiles 函数在此缓冲区中放置一个MULTI_SZ字符串，其中包含符合 *pEnumRecord 中指定的条件的配置文件名称。

dwSize

一个变量，包含 pBuffer 指向的缓冲区的大小（以字节为单位）。 请参阅备注。

pnProfiles

指向变量的可选指针，该变量接收复制到 pBuffer 指向的缓冲区的配置文件名称数。 如果不需要此信息，可以为 NULL 。

返回值

如果此函数成功，则返回值为 TRUE。

如果此函数失败，则返回值为 FALSE。 有关扩展的错误信息，请调用 GetLastError。

注解

使用 WcsEnumColorProfilesSize 函数检索 dwSize 参数的值，该参数是 pBuffer 参数指向的缓冲区的大小（以字节为单位）。

如果 profileManagementScope 参数WCS_PROFILE_MANAGEMENT_SCOPE_SYSTEM_WIDE，则只考虑配置文件与设备的系统范围内关联。 如果 profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER，则仅考虑当前用户的每个用户关联。 如果从未为此用户调用 WcsSetUsePerUserProfiles ，或者最近为此用户调用 了 WcsSetUsePerUserProfiles 且其 usePerUserProfiles 参数设置为 FALSE，则 WCSEnumColorProfiles 将返回空列表。

如果WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER (当前用户设置) 存在，它将替代 profileManagementScope 参数的系统范围默认值。

此函数在 Least-Privileged 用户帐户 (LUA) 上下文中可执行。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
标头 icm.h
Library Mscms.lib
DLL Mscms.dll

另请参阅