UpdateICMRegKey

[This is preliminary documentation and subject to change.]

(Obsolete; retained in future versions of Windows and Windows NT for compatibility)

The UpdateICMRegKey function manages color profiles and Color Management Modules in the system.

BOOL UpdateICMRegKey(
  DWORD dwReserved,
  LPTSTR lpszCMID, 
  LPTSTR lpszFileName,
  UINT nCommand
);
 

Parameters

dwReserved

Reserved, must be set to zero.

lpszCMID

Points to a string that specifies the ICC profile identifier for the color management DLL to use with the profile.

lpszFileName

Points to a fully qualified ICC color profile file name or to a DEVMODE structure.

nCommand

Specifies a function to execute. It can have one of the following values:

ICM_ADDPROFILE	Installs the ICC profile in the system.
ICM_DELETEPROFILE	Uninstalls the ICC profile from the system, but does not delete the file.
ICM_QUERYPROFILE	Determines whether the profile is already installed in the system.
ICM_SETDEFAULTPROFILE	Makes the profile first among equals.
ICM_REGISTERICMATCHER	Registers a CMM in the system. The pszFileName parameter points to a fully qualified path for the CMM DLL. The lpszCMID parameter points to a DWORD identifying the CMM.
ICM_UNREGISTERICMATCHER	Unregisters the CMM from the system. The lpszCMID parameter points to a DWORD identifying the CMM.
ICM_QUERYMATCH	Determines whether a profile exists based on the DEVMODE structure pointed to by the pszFileName parameter.

Return Values

If this function succeeds, the return value is TRUE.

If this function fails, the return value is FALSE.

Remarks

Not all parameters are used by all functions. The nCommand parameter specifies the function to execute.

This function is retained for backward compatibility and will be removed in the future.

QuickInfo

  Windows NT: Requires version 4.0 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in wingdi.h.
  Import Library: Use gdi32.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

Color Management Overview, Obsolete ICM Functions