RetTagHandle

This method frees the memory associated with the tag handle.   Each call to GetTagHandle allocates a small structure in memory which points to the tag parameters.  This function frees this structure.

void RetTagHandle(
  LONG TagHandle // Handle of tag to be freed
)

Parameters:
TagHandle Handle of tag to be freed

Return Values:
None

Example:
var Tl, Th, TagInfo;

Tl = CAS.New();
CAS.AddTag(Tl,"SUBJECT","This is a test.");

if ((Th = CAS.GetTagHandle(Tl,"SUBJECT",0)) != null)
  {
  TagInfo  = "Tag ID is " + CAS.GetIdFromHandle(Th) + "\r\n";
  TagInfo += "Tag data is " + CAS.GetTagData(Th) + "\r\n";
  TagInfo += "Tag data length is " + CAS.GetTagDataLength(Th) + "\r\n";
  TagInfo += "Tag data type is " + CAS.GetTagDataType(Th) + "\r\n";

  CAS.RetTagHandle(Th);
  }
else
  {
  TagInfo = "Tag not found";
  }

CAS.Delete(Tl);

See Also:
CAS GetTagHandle, CAS GetTag