WcsDisassociateColorProfileFromDevice 函数 (icm.h)

  • 项目

从计算机上的指定设备取消关联指定的 WCS 颜色配置文件。

注意

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

语法

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

parameters

scope

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

pProfileName

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

pDeviceName

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

返回值

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

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

注解

应安装 WCS 颜色配置文件。 此外，必须使用与设备与配置文件关联的相同 profileManagementScope 值。 请参阅 WcsAssociateColorProfileWithDevice。

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

如果多个颜色配置文件与设备相关联，WCS 将使用最后一个关联的配置文件作为默认值。 例如，如果应用程序按顺序将三个配置文件与设备关联，则 WCS 将使用关联的最后一个配置文件作为默认值。 如果应用程序随后调用 WcsDisassociateColorProfileFromDevice 函数来取消关联第三个配置文件 (这是本示例中的默认配置文件) ，则 WCS 将使用第二个配置文件作为默认值。

如果应用程序取消关联设备中的所有配置文件，WCS 将使用 sRGB 配置文件作为默认值。

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

要求

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

另请参阅