Configuration - Merge Healthcare

Merge DICOM Toolkit Reference Manual
22
MC_Add_Standard_Attribute
Adds a new DICOM standard attribute to a message object.
Synopsis
#include “mc3msg.h”
MC_STATUS MC_Add_Standard_Attribute (
int MsgFileItemID,
unsigned long Tag
)
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.
Tag DICOM tag which identifies the attribute.
Remarks
MC_Add_Standard_Attribute adds an attribute that exists in the DICOM Data
Dictionary (a standard attribute) to an existing message. Adding this attribute
may make the message non-conformant to DICOM since all necessary attributes
should be determined by the service and command specified in the
MC_Open_Message function. This implies MC_Validate_Message would
report an error when used to validate such a message. This function might be
used to construct a message to communicate with another non-conformant
application.
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.
MC_TAG_ALREADY_EXISTS The message already contains an
attribute with an ID of Tag.
MC_INVALID_TAG The Data Dictionary does not contain an
attribute with an ID of Tag.
MC_SYSTEM_ERROR An unexpected, potentially serious,
problem was detected in the operating
environment. A message describing the
error has been written to the Merge
DICOM Toolkit log file.
See Also
MC_Add_Nonstandard_Attribute MC_Delete_Attribute
MC_Add_Private_Attribute MC_Delete_Private_Attribute
MC_Add_Private_Block MC_Delete_Private_Block
MC_Delete_Range