ConvertIndexToColorName function (icm.h)

Transforms indices in a color space to an array of names in a named color space.

Syntax

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

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 value

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

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Header icm.h
Library Mscms.lib
DLL Mscms.dll

See also