SetColorProfileElementSize

[This is preliminary documentation and subject to change.]

SetColorProfileElementSize sets the size of a tagged element.

BOOL WINAPI SetColorProfileElementSize(
  HPROFILE hProfile,
  TAGTYPE tag,
  DWORD cbSize
);
 

Parameters

hProfile

Specifies a handle to the color profile in question.

tag

Identifies the tagged element.

cbSize

Specifies the size to set the tagged element to. If cbSize is zero, this function deletes the specified tagged element. If the tag is a reference, only the tag table entry is deleted, not the data.

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

To create a new tagged element in a color profile, use SetColorProfileElementSize to set the size, then use SetColorProfileElement to set the element value.

If the specified tag already exists in the profile, SetColorProfileElementSize changes the size of the element by truncating it or adding zeroes at the end as the case may be.

If the specified tag already exists and is a reference to another tag, SetColorProfileElementSize creates a new data area for the tag that is not shared.

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, SetColorProfileElement