In This Topic ▼

L_DeleteICCTag

Summary

Deletes a tag from the ICC profile.

Syntax

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

L_LTCLR_API L_INT L_DeleteICCTag(pICCProfile, uTagSig, pTag)

Parameters

pICCPROFILEEXT pICCProfile

Pointer to the ICCPROFILEEXT structure that contains the tag to delete.

L_UINT32 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.

Pointer to a buffer to be updated with the deleted tag. This parameter can be NULL, if the old tag data is not desired. If this parameter is not NULL, the pointer must point to a buffer large enough to store the tag values.

Returns

Value	Meaning
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

Win32, x64.

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; 
}