In This Topic ▼

LDicomDS::SetBinaryValue

Summary

Sets the binary value of an element.

Syntax

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

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

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

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