AssociateColorProfileWithDeviceW 函数 (icm.h)

  • 项目

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

注意

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

语法

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

parameters

pMachineName

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

pProfileName

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

pDeviceName

指向要关联的设备的名称。

返回值

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

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

注解

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

请注意，在 Windows (Windows 95 或更高版本) 下，适用于打印机的 PostScript 设备驱动程序采用 CMYK 颜色模型。 因此，所有 PostScript 打印机都必须使用 CMYK 颜色配置文件。 Windows 2000 没有此限制。

如果指定的设备是监视器，则此函数会更新默认配置文件。

根据纸张和墨迹类型，多个配置文件通常与打印机相关联。 没有默认值。 当应用程序 (DC) 创建设备上下文时，GDI 会从关联的配置文件中选择最佳配置文件。

扫描程序也没有默认配置文件。 但是，将多个配置文件与扫描仪相关联是非典型情况。

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

要求

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

另请参阅