LDicomDS::SetBinaryValue

#include "Ltdic.h"

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

L_BOOL LDicomDS::SetBinaryValue(pElement, hFile, nFileOffset, nLength);

pDICOMELEMENT pElement;

pointer to a DICOMELEMENT structure

L_VOID * pValue;

pointer to a buffer

L_HFILE hFile;

handle to a file

L_OFFSET nFileOffset;

file offset

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.
hFile Handle to a file to read binary data from.
nFileOffset File offset (from file begging) to where should read the data from.
nLength Length, in bytes, of the allocated buffer.

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

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS DICOM C++ Class Library Help
Introduction
Version History
Getting Started
LEADTOOLS DICOM Features
Redistributables/Files To Be Included With Your Application
Quick Reference
Classes and Member Functions
CallBack Functions
Appendix