Configuration - Merge Healthcare

Merge DICOM Toolkit Reference Manual
See Also
MC_Get_pValue... Functions MC_Get_pValue_To_Function
MC_Get_Next_pValue... Functions MC_Get_Value_To_Function
MC_Get_Next_Value... Functions
MC_Get_Value_Count
Returns the number of values assigned to an attribute in a message object.
Synopsis
#include “mc3msg.h”
MC_STATUS MC_Get_Value_Count (
int MsgFileItemID,
unsigned long Tag,
int* CountPtr
)
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.
CountPtr The number of values the attribute contains is returned here.
Remarks
MC_Get_Value_Count returns the number of values assigned to an attribute in a
message object. The number is returned at *CountPtr.
Only certain attributes are allowed to contain multiple values and be conformant
to the DICOM standard. The developer usually knows ahead of time which
attributes will contain multiple values and which will not. Some attributes, such as
those with value representations of OB or OW, may never contain more than one
value.
Return Value
One of these enumerated MC_STATUS codes define in “mcstatus.h”:
Value Meaning
MC_NORMAL_COMPLETION The function completed normally.
MC_NULL_POINTER_PARM CountPtr was NULL.
MC_INVALID_TAG The message does not contain an
attribute with an ID of Tag.
MC_INVALID_MESSAGE_ID MsgFileItemID is not a valid message
object ID, file object ID or item object ID.
MC_NULL_VALUE The attribute contains a NULL value (i.e.
its value is of length zero).
MC_EMPTY_VALUE No value has been assigned to the
attribute.
145