L_DicomDeleteTag

#include "Ltdic.h"

L_LTDIC_API pDICOMTAG L_DicomDeleteTag(pTag)

pDICOMTAG pTag;

/* pointer to a DICOMTAG structure */

Deletes the specified item from the Data Element Tag Table.

Parameter

Description

pTag

Pointer to a DICOMTAG structure that contains the item to be deleted.

Returns

!NULL

A pointer to an adjacent item. If there is an item following the item being deleted, the returned pointer will point to this item. If the item being deleted does not have an item following it, but has an item preceding it, the pointer points to the item immediately preceding the deleted item.

NULL

The table is empty.

Comments

You can remove all items from the table using L_DicomResetTag.

Required DLLs and Libraries

LTDIC

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

See Also

Functions:

L_DicomResetTag, L_DicomGetFirstTag, L_DicomGetLastTag, L_DicomGetPrevTag, L_DicomGetNextTag, L_DicomFindTag, L_DicomFindIndexTag, L_DicomInsertTag

Topics:

Working with Tags

Example

This example removes an item from the Tag table

L_INT DicomDeleteTagExample(L_VOID)
{
   pDICOMTAG pTag;

   pTag = L_DicomFindTag(TAG_FILE_META_INFORMATION_VERSION);
   if (pTag != NULL)
      L_DicomDeleteTag(pTag);

   return DICOM_SUCCESS;
}