UpdateICMRegKey
(Obsolete; retained for backward compatibility)
The UpdateICMRegKey function manages color profiles and Color Management Modules in the system.
BOOL UpdateICMRegKey(
DWORD dwReserved, LPTSTR lpszCMID, LPTSTRlpszFileName, 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.Value Meaning 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 may be removed in future versions of ICM.
Windows 95/98/Me: UpdateICMRegKeyW is supported by the Microsoft Layer for Unicode. To use this, you must add certain files to your application, as outlined in Microsoft Layer for Unicode on Windows 95/98/Me Systems.
Requirements
** Windows NT/2000/XP/Vista:** Included in Windows NT 4.0 and later.
** Windows 95/98/Me:** Included in Windows 95 and later.
** Header:** Declared in Wingdi.h.
** Library:** Use Gdi32.lib.
** Unicode:** Implemented as Unicode and ANSI versions on Windows NT/2000/XP. Also supported by Microsoft Layer for Unicode.