DisassociateColorProfileFromDeviceW 函数 (icm.h)

  • 项目

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

注意

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

语法

BOOL DisassociateColorProfileFromDeviceW(
  PCWSTR pMachineName,
  PCWSTR pProfileName,
  PCWSTR pDeviceName
);

parameters

pMachineName

保留。 必须为 NULL。 此参数旨在指向要取消关联指定配置文件和设备的计算机的名称。 NULL 指针指示本地计算机。

pProfileName

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

pDeviceName

指向要取消关联的设备名称的指针。

返回值

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

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

注解

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

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

DisassociateColorProfileFromDevice 始终从指定设备的当前用户的按用户配置文件关联列表中删除指定的配置文件。 从列表中删除配置文件之前， DisassociateColorProfileFromDevice 确定用户之前是否表示希望对设备使用每用户配置文件关联列表。 如果是这样，则 DisassociateColorProfileFromDevice 只需从设备的现有每用户配置文件关联列表中删除指定的配置文件。 如果没有，则 DisassociateColorProfileFromDevice 通过复制该设备的系统范围的关联列表为该设备创建新的每用户配置文件关联列表。 然后，它会从每用户列表中删除指定的配置文件。 从此开始，当前用户将为指定设备使用每用户配置文件关联列表，就好像已为 pDevice 调用了 WcsSetUsePerUserProfiles，并将 usePerUserProfiles 参数设置为 TRUE。

要求

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

另请参阅