Configuration - Merge Healthcare

Merge DICOM Toolkit Reference Manual
42
See Also
MC_Add_Standard_Attribute MC_Delete_Attribute
MC_Add_Private_Attribute MC_Delete_Private_Attribute
MC_Add_Private_Block MC_Delete_Range
MC_Add_Nonstandard_Attribute
MC_Delete_Range
Removes a range of attributes from a message object.
Synopsis
#include “mc3msg.h”
MC_STATUS MC_Delete_Range (
int MsgFileItemID,
unsigned long FirstTag,
unsigned long LastTag
)
MsgFileItemID The identifier assigned to this object by the
MC_Open_Message, MC_Open_Empty_Message,
MC_Create_File, MC_Create_Empty_File, or MC_Open_Item
functions.
FirstTag Identifier of the first attribute which is to be removed from the
message object.
LastTag Identifier of the last attribute which is to be removed from the
message object.
Remarks
MC_Delete_Range removes a range of attributes (standard or nonstandard)
from an existing message. Removing these attributes may make the message
non-conformant to DICOM since all necessary attributes are determined by the
service and command specified by MC_Open_Message. All attributes with tags
equal to or greater than FirstTag and equal to or less than LastTag will be
removed. FirstTag and LastTag need not exist in the message.
Return Value
One of these enumerated MC_STATUS codes define in “mcstatus.h”:
Value Meaning
MC_NORMAL_COMPLETION The function completed normally.
MC_INVALID_MESSAGE_ID MsgFileItemID is not a valid message
object ID, file object ID or item object ID.
See Also
MC_Add_Standard_Attribute MC_Delete_Attribute
MC_Add_Private_Attribute MC_Delete_Private_Attribute
MC_Add_Private_Block MC_Delete_Private_Block
MC_Add_Nonstandard_Attribute