LDicomDS::SetBinaryValue

#include "Ltdic.h"

L_BOOL LDicomDS::SetBinaryValue(pElement, pValue, nLength)

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
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:	LDicomDS::SetCharValue, LDicomDS::SetShortValue, LDicomDS::SetLongValue, LDicomDS::SetFloatValue, LDicomDS::SetDoubleValue, LDicomDS::SetStringValue, LDicomDS::SetAgeValue, LDicomDS::SetDateValue, LDicomDS::SetTimeValue, LDicomDS::SetDateTimeValue
Topics:	Working with Data Sets
	How to Disable the Automatic Loading of the default DICOM IOD Table

Example

This example sets the value for an element.

L_INT LDicomDS_SetBinaryValueExample()
{
   LDicomDS      *pDS;
   pDICOMELEMENT  pElement;
   L_UCHAR        Value[2];
  Value[0] = 0;
  Value[1] = 1;
   pDS = new LDicomDS(NULL);
   pDS->InitDS( CLASS_CR_IMAGE_STORAGE, 0); 
   pElement = pDS->FindFirstElement(NULL, TAG_CLINICAL_TRIAL_PROTOCOL_ID, FALSE);
   if (pElement != NULL)
   {
      pDS->SetBinaryValue(pElement, Value, 2);
   }
   delete pDS;
   return DICOM_SUCCESS;
}