CMConvertColorNameToIndex function

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

Syntax

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 value

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.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Wingdi.h

Library

Gdi32.lib

DLL

Icm32.dll

See also

Basic Color Management Concepts

Functions