L_DicomSetBinaryValue

#include "Ltdic.h"

L_LTDIC_API L_BOOL 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

Platforms

Win32, x64

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_INT DicomSetBinaryValueExample(L_VOID)
{
   HDICOMDS      hDS;
   pDICOMELEMENT pElement;
   L_UCHAR        Buffer[2];
   hDS = L_DicomCreateDS(NULL);

   Buffer[0] = 0;
   Buffer[1] = 1;
   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, Buffer, 2);

   L_DicomFreeDS(hDS);
   return DICOM_SUCCESS;
}