WcsAssociateColorProfileWithDevice 函数 (icm.h)

  • 项目

将指定的 WCS 颜色配置文件与指定的设备相关联。

注意

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

语法

BOOL WcsAssociateColorProfileWithDevice(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PCWSTR                       pProfileName,
  PCWSTR                       pDeviceName
);

parameters

scope

一个 WCS_PROFILE_MANAGEMENT_SCOPE值，该值指定此配置文件管理操作的范围，可以是系统范围或当前用户的作用域。

pProfileName

指向要关联的配置文件的文件名的指针。

pDeviceName

指向要与配置文件关联的设备名称的指针。

返回值

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

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

注解

如果尚未使用 InstallColorProfileW 函数在计算机上安装配置文件，则 WCSAssociateColorProfileWithDevice 函数将失败。

如果 profileManagementScope 参数WCS_PROFILE_MANAGEMENT_SCOPE_SYSTEM_WIDE，则配置文件关联是系统范围的，适用于所有用户。 如果 profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER，则关联仅适用于当前用户。

如果WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER profileManagementScope ，则此函数在 Least-Privileged 用户帐户 (LUA) 上下文中是可执行的。 否则，需要管理权限。

要求

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

另请参阅