GetColorProfileElementTag

[This is preliminary documentation and subject to change.]

The GetColorProfileElementTag function retrieves the tag name specified by dwIndex in the tag table of a given color profile, where dwIndex is a one-based index into that table.

BOOL WINAPI GetColorProfileElementTag(
  HPROFILE hProfile,
  DWORD dwIndex,
  PTAGTYPE pTag
);
 

Parameters

hProfile
Specifies a handle to the color profile in question.
dwIndex
Specifies the one-based index of the tag to retrieve.
pTag
Pointer to a variable in which the tag name is to be placed.

Return Values

If this function succeeds, the return value is TRUE.

If this function fails, the return value is FALSE. For extended error information, call GetLastError.

Remarks

GetColorProfileElementTag can be used to enumerate all tags in a profile after getting the number of tags in the profile using GetCountColorProfileElements.

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Requires Windows 98.
  Windows CE: Unsupported.
  Header: Declared in icm.h.
  Import Library: Use mscms.lib.

See Also

Color Management Overview, ICM 2.0 Functions