L_DicomSetBinaryValue

#include "Ltdic.h"

L_BOOL EXT_FUNCTION L_DicomSetBinaryValue(hDS, pElement, pValue, nLength)

HDICOMDS hDS;	/* a DICOM handle */
pDICOMELEMENT pElement;	/* pointer to a DICOMELEMENT structure */
L_VOID * pValue;	/* pointer to a buffer */
L_UINT32 nLength;	/* length of the buffer */

Sets the binary value of an element.

Parameter	Description
hDS	A DICOM handle.
pElement	Pointer to a DICOMELEMENT structure within the Data Set.
pValue	Buffer that contains the binary value to set.
nLength	Length, in bytes, of the buffer you allocated.

Returns

TRUE	The binary value of the Data Element was set successfully.
FALSE	Could not set the binary value of the Data Element.

Comments

This function overwrites the value of the Data Element. The Value Length of the Data Element is then equal to nLength.

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

See Also

Functions:	L_DicomSetCharValue, L_DicomSetShortValue, L_DicomSetLongValue, L_DicomSetFloatValue, L_DicomSetDoubleValue, L_DicomSetStringValue, L_DicomSetAgeValue, L_DicomSetDateValue, L_DicomSetTimeValue, L_DicomSetDateTimeValue
Topics:	Working with Data Sets

Example

/* This example sets the value for an element */

L_VOID Test()
{
   HDICOMDS      hDS;
   pDICOMELEMENT pElement;
   L_CHAR        szText[]="Jimmy^Green";

   hDS = L_DicomCreateDS(NULL);

   L_DicomInitDS(hDS, CLASS_XA_BIPLANE_IMAGE_STORAGE_RETIRED, 0);

   pElement = L_DicomFindFirstElement(hDS, NULL, TAG_PATIENT_NAME, FALSE);
   if (pElement != NULL)
   {
      L_DicomSetBinaryValue(hDS, pElement, szText, strlen(szText));
   }

   L_DicomFreeDS(hDS);
}