CMConvertColorNameToIndex

[This is preliminary documentation and subject to change.]

The CMConvertColorNameToIndex function converts color names in a named color space to index numbers in a color profile

BOOL WINAPI CMConvertColorNameToIndex(
  HPROFILE hProfile, 
  PCOLOR_NAME paColorName,
  PDWORD paIndex,
  DWORD dwCount
);
 

Parameters

hProfile

The handle to a named color profile.

paColorName

Pointer to an array of color name structures.

paIndex

Pointer to an array of DWORDS that this function fills with the indices.

dwCount

The number of color names to convert.

Return Values

If this function succeeds with the conversion, the return value is TRUE.

If this function fails, the return value is FALSE. When this occurs, the CMM should call SetLastError to set the last error to a valid error value defined in Winerror.h.

Remarks

This function is required in the default CMM. It is optional for all other CMMs.

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Requires Windows 98.
  Windows CE: Unsupported.
  Header: Declared in wingdi.h.
  Import Library: Use gdi32.lib.

See Also

Color Management Overview, ICM 2.0 Functions