CMConvertIndexToColorName

[This is preliminary documentation and subject to change.]

The CMConvertIndexToColorName transforms indices in a color space to an array of names in a named color space.

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

Parameters

hProfile

The handle to a color space profile.

paIndex

Pointer to an array of color-space index numbers.

paColorName

Pointer to an array of color name structures.

dwCount

The number of indices to convert.

Return Values

If this conversion function succeeds, 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