通过

WcsOpenColorProfileA 函数 (icm.h)

  • 项目

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

语法

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

parameters

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

指向配置文件结构的指针，该结构指定 WCS 域映射模型配置文件 (GMMP) 。 创建句柄后，可以释放 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，WCS 路径中将忽略 dwDesiredAccess 标志PROFILE_READWRITE。

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

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

要求

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

另请参阅