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

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

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