UpdateICMRegKey

Overview

Group

Quick Info

Windows NT
No
Win95
Yes
Win32s
No
Import Library

Header File
wingdi.h
Unicode
No
Platform Notes
None

The UpdateICMRegKey function installs, removes, or queries registry entries that identify ICC color profiles or color-matching DLLs. The function carries out the action specified by the nCommand parameter.

BOOL UpdateICMRegKey(

DWORD dwReserved,
DWORD CMID,
LPTSTR lpszFileName,
UINT nCommand
);

Parameters
dwReserved

Reserved; must be zero.

CMID

Profile identifier of the color-matching DLL to use with the profile.

lpszFileName

Pointer to a zero-terminated string that specifies the filename of an ICC color profile or address of a DEVMODE structure, depending on the value of nCommand.

nCommand

Action flag. This parameter can have one of the following values:

ICM_ADDPROFILE	Adds the ICC profile to the ICM branch in the registry.
ICM_DELETEPROFILE	Deletes the ICC profile from the ICM branch in the registry.
ICM_QUERYPROFILE	Determines if the profile is in the ICM branch of the registry.
ICM_SETDEFAULTPROFILE	Makes the profile first among equals.
ICM_REGISTERICMATCHER	Equates a CMID to a color-matching DLL.
ICM_UNREGISTERICMATCHER	Removes the reference between CMID and a color-matching DLL.
ICM_QUERYMATCH	Determines if a profile exists based on the DEVMODE pointed to by lpszFileName.

Return Values
If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Remarks
GDI uses the registry to keep track of ICC profiles installed in the system (listed in the registry). Although not required, if ICC profiles are copied to a local directory, they should be placed in the Color directory in the Windows System directory.