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