通过

WcsOpenColorProfileW 函数 (icm.h)

  • 项目

创建指定颜色配置文件的句柄。

语法

HPROFILE WcsOpenColorProfileW(
  PPROFILE pCDMPProfile,
  PPROFILE pCAMPProfile,
  PPROFILE pGMMPProfile,
  DWORD    dwDesireAccess,
  DWORD    dwShareMode,
  DWORD    dwCreationMode,
  DWORD    dwFlags
);

参数

pCDMPProfile

指向指定配置文件的 WCS DMP 或 ICC 颜色配置文件结构的指针。 创建句柄后，可以释放 pCDMPProfile 指针。 如果配置文件是 ICC，并且其 dwType 成员设置为 DONT_USE_EMBEDDED_WCS_PROFILES， 则 WcsOpenColorProfile 将忽略 ICC 配置文件中的任何嵌入式 WCS 配置文件。

pCAMPProfile

指向配置文件结构的指针，该结构指定 WCS 颜色外观模型配置文件 (CAMP) 。 创建句柄后，可以释放 pCAMPProfile 指针。 如果 为 NULL，则使用默认 CAMP，在查询默认 CAMP 时使用当前用户设置WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER。

pGMMPProfile

指向配置文件结构的指针，该结构指定 GMMP) (WCS 域映射模型配置文件。 创建句柄后，可以释放 pGMMPProfile 指针。 如果 为 NULL，则使用默认呈现意向的默认 GMMP，在查询默认 GMMP 时使用当前用户设置（WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER）。 有关呈现意向的说明，请参阅 呈现意向。

dwDesireAccess

一个标志值，该值指定如何访问指定的颜色配置文件。 此参数必须采用以下值之一：

值 说明
PROFILE_READ 指定打开颜色配置文件以便进行只读访问。
PROFILE_READWRITE 指定打开颜色配置文件以用于读取和写入访问。 如果配置文件是 WCS 配置文件，则忽略此标志的值。

dwShareMode

一个标志值，该值指定在打开文件中包含的颜色配置文件时要执行的操作。 此参数必须采用以下值之一，这些值在 winnt.h 中定义：

值 说明
FILE_SHARE_READ 指定可以对配置文件执行读取访问) 操作的其他打开 (。
FILE_SHARE_WRITE 指定可以对配置文件执行其他打开 (，以执行写入访问) 操作。 打开 WCS 配置文件时，将忽略此标志值。

dwCreationMode

一个标志值，该值指定打开颜色配置文件（如果它包含在文件中）时要执行的操作。 此参数必须采用以下值之一，这些值在 winbase.h 中定义：

值 说明
CREATE_NEW 指定创建新配置文件。 如果配置文件已存在，此函数将失败。
CREATE_ALWAYS 指定创建新配置文件。 如果配置文件已存在，则会覆盖该配置文件。
OPEN_EXISTING 指定打开配置文件。 如果配置文件不存在，此函数将失败。
OPEN_ALWAYS 指定如果存在国际颜色联盟 (ICC) 文件，则打开配置文件。 如果 ICC 配置文件不存在，WCS 会创建新的 ICC 配置文件。 如果设置了此标志并且 WCS 配置文件不存在，则函数将失败。
TRUNCATE_EXISTING 指定将配置文件打开并截断为零个字节。 如果配置文件不存在，函数将失败。

dwFlags

一个标志值，该值指定是否使用嵌入的 WCS 配置文件。 除非 pCDMProfile 指定包含嵌入式 WCS 配置文件的 ICC 配置文件，否则此参数不起作用。

此参数采用以下值之一：

值 说明
0 指定将使用嵌入的 WCS 配置文件，并将忽略 pCDMPProfile 指定的 ICC 配置文件。
DONT_USE_EMBEDDED_WCS_PROFILES 指定将使用 pCDMPProfile 指定的 ICC 配置文件，并忽略嵌入的 WCS 配置文件。

返回值

如果此函数成功，则返回值是打开的颜色配置文件的句柄。

如果此函数失败，则返回值为 NULL。

注解

此 API 将采用一组 DMP、CAMP 和 GMMP 并返回 WCS 配置文件句柄。 GMMP 的 NULL 值有效。 CAMP 的 NULL 值将替换为默认 CAMP 值。

此 API 还将接受 ICC 配置文件。 使用 ICC 配置文件并不能保证由 WCS CITE 引擎进行处理。 仅当至少传递一个 WCS 配置文件时，才会使用 WCS 引擎。 纯 ICC 工作流将与旧行为保持一致。

可以使用此函数在其他颜色配置文件管理功能中返回的句柄。

dwCreationMode 标志CREATE_NEW、CREATE_ALWAYS和TRUNCATE_EXISTING将始终返回空白 ICC HPROFIL。 如果存在其他 dwCreationMode 标志，则函数将确定配置文件是 ICC 还是 WCS XML。

在 ICC 代码路径中，使用上表中指定的请求共享、访问和创建标志返回 ICC HPROFILE。

在 WCS 路径中，如果配置文件不存在， dwCreationMode 标志OPEN_ALWAYS将失败，因为无法在 WCS 体系结构中创建或编辑 WCS 配置文件， (必须使用 MSXML6) 对其进行编辑。 出于同样的原因， dwShareMode 标志 FILE_SHARE_WRITE，dwDesiredAccess 标志PROFILE_READWRITE在 WCS 路径中被忽略。

创建颜色配置文件的句柄后，可以删除用于创建该句柄的任何信息。

使用 CloseColorProfile 函数关闭 由 WcsOpenColorProfile 返回的对象句柄。

要求

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

另请参阅