Share via


ConvertColorNameToIndex

The ConvertColorNameToIndex function converts color names in a named color space to index numbers in an International Color Consortium (ICC) color profile.

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

Parameters

  • hProfile
    The handle to an ICC 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. The indices begin with one, not zero.
  • dwCount
    The number of color names to convert.

Return Values

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

If the 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