| LEADTOOLS DICOM C DLL Help > Function References > 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
| For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application | 
Win32, x64, Linux.
See Also
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;
}