Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

GetColorProfileElementTag Function

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

Syntax

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

Parameters

hProfile

Specifies a handle to the ICC 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 Value

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

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

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

This function does not support Windows Color System (WCS) profiles CAMP, DMP, and GMMP; because profile elements are implicitly associated with, and hard coded to, ICC tag types and there exist many robust XML parsing libraries.

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header

Icm.h

Library

Mscms.lib

DLL

Mscms.dll

See Also

Basic Color Management Concepts
Functions

 

 

Send comments about this topic to Microsoft

Build date: 11/16/2010

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.