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.

L_UCHAR * pTag

Pointer to a buffer to be updated with the deleted tag.

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