通过

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： Microsoft Layer for Unicode 支持 UpdateICMRegKeyW。 若要使用此功能，必须将某些文件添加到应用程序，如 Windows 95/98/Me 系统上的 Microsoft Layer for Unicode 中所述。

注意

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

要求

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

另请参阅