RegisterCMM

[This is preliminary documentation and subject to change.]

RegisterCMM associates a specified identification value with the specified color management module dynamic link library (CMM DLL). When this ID appears in a color profile, Windows can then locate the corresponding CMM so as to create a transform.

BOOL WINAPI RegisterCMM(
  PCTSTR pMachineName,
  DWORD cmmID,
  PCTSTR pCMMdll
);
 

Parameters

pMachineName

Reserved for future use; must currently be set to NULL, until non-local registration is supported. This parameter is intended to point to the name of the machine on which a CMM DLL should be registered. A NULL pointer indicates the local machine.

cmmID

Specifies the ID signature of the CMM registered with the International Color Consortium (ICC).

pCMMdll

Pointer to the fully qualified path name of the CMM DLL.

Return Values

If this function succeeds, the return value is TRUE.

If this function fails, the return value is FALSE. For extended error information, call GetLastError.

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Requires Windows 98.
  Windows CE: Unsupported.
  Header: Declared in icm.h.
  Import Library: Use mscms.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

Color Management Overview, ICM 2.0 Functions