通过

UpdateICMRegKeyA 函数 （wingdi.h）

  • 项目

（已过时;保留以实现向后兼容性）

UpdateICMRegKey 函数管理系统中的颜色配置文件和颜色管理模块。

语法

BOOL UpdateICMRegKeyA(
  DWORD reserved,
  LPSTR lpszCMID,
  LPSTR lpszFileName,
  UINT  command
);

参数

reserved

保留，必须设置为零。

lpszCMID

指向一个字符串，该字符串指定要用于配置文件的颜色管理 DLL 的 ICC 配置文件标识符。

lpszFileName

指向完全限定的 ICC 颜色配置文件文件名或 DEVMODE 结构。

command

指定要执行的函数。 它可以具有以下值之一。

 

价值 意义
ICM_ADDPROFILE
 在系统中安装 ICC 配置文件。
ICM_DELETEPROFILE
 从系统卸载 ICC 配置文件，但不删除该文件。
ICM_QUERYPROFILE
 确定配置文件是否已安装在系统中。
ICM_SETDEFAULTPROFILE
 将配置文件设为第一个等值。
ICM_REGISTERICMATCHER
 在系统中注册 CMM。 pszFileName 参数指向 CMM DLL 的完全限定路径。 lpszCMID 参数指向标识 CMM 的 DWORD。
ICM_UNREGISTERICMATCHER
 从系统取消注册 CMM。 lpszCMID 参数指向标识 CMM 的 DWORD。
ICM_QUERYMATCH
 根据 pszFileName 参数所指向的 DEVMODE 结构确定配置文件是否存在。

返回值

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

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

言论

并非所有参数都由所有函数使用。 nCommand 参数指定要执行的函数。

此函数保留以实现向后兼容性，并可能在 ICM 的未来版本中删除。

Windows 95/98/Me：Unicode Microsoft 层支持 UpdateICMRegKeyW。 若要使用此功能，必须将某些文件添加到应用程序，如 Windows 95/98/Me 系统上的 Unicode Microsoft 层中所述。

注意

wingdi.h 标头将 UpdateICMRegKey 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 wingdi.h
库 Gdi32.lib
DLL Gdi32.dll

另请参阅