LDicomDS::SetBinaryValue

#include "Ltdic.h"

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

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

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

L_BOOL LDicomDS::SetBinaryValue(pElement, pszFileName);

Sets the binary value of an element.

Parameters

pDICOMELEMENT pElement

Pointer to a DICOMELEMENT structure within the Data Set.

L_VOID * pValue

Buffer that contains the binary value to set.

L_HFILE hFile

Handle to a file from where the binary data should be read.

L_OFFSET nFileOffset

File offset (from file beginning) from where the data should be read.

L_UINT32 nLength

Length, in bytes, of the allocated buffer.

const L_TCHAR* pszFileName

Name of a file where the data should be read.

L_BOOL bRedirectedFile

A value that indicates if a copy of the hFile handle is made for redirection. Possible values are:

Value Meaning
TRUE Redirection occurs directly using hFile.
FALSE Redirection occurs on a copy of hFile.

Returns

Value Meaning
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

Platforms

Win32, x64

See Also

Functions

Topics

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 21.0.2021.7.2
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS DICOM C++ Class Library Help

Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.