Share via


ConvertIndexToColorName

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

BOOL WINAPI ConvertIndexToColorName(
  HPROFILE hProfile,PDWORDpaIndex,
  PCOLOR_NAME paColorName,
  DWORDdwCount);

Parameters

  • hProfile
    The handle to an International Color Consortium (ICC) color space profile.
  • paIndex
    Pointer to an array of color-space index numbers. The indices begin with one, not zero.
  • 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 conversion function fails, the return value is FALSE.

Remarks

This function will fail if hProfile is not a valid ICC profile.

This function does not support Windows Color System (WCS) profiles CAMP, DMP, and GMMP; because named profiles are explicit ICC profile types.

Requirements

**  Windows NT/2000/XP/Vista:** Included in Windows 2000 and later.
**  Windows 95/98/Me:** Included in Windows 98 and later.
**  Header:** Declared in Icm.h.
**  Library:** Use Mscms.lib.

See Also

Basic Color Management Concepts, Functions