通过

SetStandardColorSpaceProfileW 函数 (icm.h)

  • 项目

为给定的标准 颜色空间注册指定的配置文件。 可以使用 GetStandardColorSpaceProfileW 查询配置文件。

语法

BOOL SetStandardColorSpaceProfileW(
  PCWSTR pMachineName,
  DWORD  dwProfileID,
  PCWSTR pProfileName
);

parameters

pMachineName

保留。 必须为 NULL。 此参数旨在指向要设置标准颜色空间配置文件的计算机的名称。 NULL 指针指示本地计算机。

dwProfileID

指定给定配置文件表示的标准颜色空间的 ID 值。 这是一个自定义 ID 值，用于唯一标识应用程序中的颜色空间配置文件。

pProfileName

指向配置文件的完全限定路径。

返回值

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

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

注解

必须先在系统上安装配置文件，然后才能将其注册到标准颜色空间。

除了国际颜色联盟 (ICC) 配置文件外，此函数还支持 Windows 颜色系统 (WCS) 设备模型配置文件 (DMP) 。 它不支持 WCS CAMP 或 GMMP 配置文件，如果使用此类配置文件，将返回错误。

每用户/LUA 支持

这将仅为当前用户注册给定标准颜色空间的指定配置文件。

这将 WcsSetDefaultColorProfile 与 WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER 配合使用。

如果已安装配置文件，则这是 LUA 上下文中的可执行文件，否则会失败并拒绝访问，因为安装是系统范围的并且需要管理员权限。

要求

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

另请参阅