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 |