L_DeleteICCTag

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

L_LTCLR_API L_INT L_DeleteICCTag(pICCProfile, uTagSig, pTag)

pICCPROFILEEXT pICCProfile;	/* pointer to a structure */
L_UINT32 uTagSig;	/* a value that indicates the tag signature */
L_UCHAR * pTag;	/* 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_InitICCProfile, L_FreeICCProfile, L_SaveICCProfile, L_LoadICCProfile, 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_SetICCProfileId, L_2bFixed2bNumberToDouble, L_U8Fixed8NumberToDouble, L_DoubleToU8Fixed8Number, L_DoubleTo2bFixed2bNumber, L_SetICCTagData, L_GetICCTagData, L_CreateICCTagData, L_GenerateICCFile, L_GenerateICCPointer, L_GetICCTagTypeSig, L_FreeICCTagType, 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_INT DeleteICCTagExample(pICCPROFILEEXT pICCProfile,
                                          L_UINT32       uTagSig,
                                          L_UCHAR      * pTagData)
{
   L_INT nRet;
   nRet = L_DeleteICCTag(pICCProfile, uTagSig, pTagData);
   if(nRet != SUCCESS)
      return nRet;
   return SUCCESS;
}