L_DeleteICCTag

#include "ltkrn.h"
#include "ltclr.h"

L_INT EXT_FUNCTION L_DeleteICCTag(pICCProfile, uTagSig, pTag)

pICCPROFILEEXT pICCProfile;	/* pointer to a structure */
L_UINT32 uTagSig;	/* a value that indicates the tag signature */
L_UCHAR L_FAR * pTagData;	/* pointer to a buffer of data */

Deletes a tag from the ICC profile.

Parameter	Description
pICCProfile	Pointer to the ICCPROFILEEXT structure that contains the tag to delete.
uTagSig	A value that indicates the signature of the tag to delete from the ICC profile. Possible values include private tag types and the values listed in ICCTAGSIGNATURE.
pTag	Pointer to a buffer to be updated with the deleted tag.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

This function deletes the desired tag from the ICC profile. Before deleting it however, it makes a copy of the tag, and updates the pTag parameter with a pointer to the copy.

Required DLLs and Libraries

LTCLR

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Windows 95 / 98 / Me, Windows 2000 / XP.

See Also

Functions:	L_FreeICCProfile, L_InitICCProfile, L_LoadICCProfile, L_InitICCProfileExt, L_FreeICCProfileExt, L_SaveICCProfile, L_LoadICCProfileExt, L_FillICCProfileStructure, L_FillICCProfileFromICCFile, L_InitICCHeader, L_SetICCCMMType, L_SetICCDeviceClass, L_SetICCColorSpace, L_SetICCConnectionSpace, L_SetICCPrimaryPlatform, L_SetICCFlags, L_SetICCDevManufacturer, L_SetICCDevModel, L_SetICCDeviceAttributes, L_SetICCRenderingIntent, L_SetICCCreator, L_SetICCDateTime, L_2bFixed2bNumberToDouble, L_DoubleTo2bFixed2bNumber, L_SetICCTagData, L_GetICCTagData, L_CreateICCTagData, L_GenerateICCFile, L_GenerateICCPointer, L_GetICCTagTypeSig, L_FreeICCTagType, L_SetICCProfileId, L_U8Fixed8NumberToDouble, L_DoubleToU8Fixed8Number, L_ConvertParametricCurveTypeToBuffer, L_ConvertCurveTypeToBuffer, L_ConvertCLUTToBuffer, L_GetParametricCurveNumberOfParameters
Topics:	Using ICC Profile Functions
	ICC Profile Functions: Tags

Example

/* This function deletes a tag from an ICC profile */
L_VOID DeleteTag(pICCPROFILEEXT pICCProfile, L_UINT32 uTagSig, L_UCHAR L_FAR * pTagData)
{
L_DeleteICCTag(pICCProfile, uTagSig, pTagData);
}