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; }