Export (0) Print
Expand All

UpdateICMRegKey Function

(Obsolete; retained for backward compatibility)

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

Syntax

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.

ValueMeaning
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 Value

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

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header

Wingdi.h

Library

Gdi32.lib

DLL

Gdi32.dll

Unicode and ANSI names

UpdateICMRegKeyW (Unicode) and UpdateICMRegKeyA (ANSI)

See Also

Basic Color Management Concepts
Obsolete WCS Functions

 

 

Send comments about this topic to Microsoft

Build date: 11/16/2010

Community Additions

ADD
Show:
© 2014 Microsoft