L_DicomGetPreamble

#include "Ltdic.h"

L_LTDIC_API L_VOID L_DicomGetPreamble(hDS, pPreamble, nLength)

HDICOMDS hDS;

a DICOM handle

L_UCHAR * pPreamble;

character string

L_UINT16 nLength;

length of pPreamble

Gets the contents of the files preamble.

Parameter

Description

hDS

A DICOM handle.

pPreamble

Character string to be updated with the contents of the preamble.

nLength

Length of pPreamble, in bytes. The maximum length is DS_PREAMBLE_LENGTH, which is defined as 128.

Returns

None.

Comments

To set the Preamble use L_DicomSetPreamble.

If the value specified in nLength is >= DS_PREAMBLE_LENGTH, then pPreamble will be updated with the entire Preamble. If nLength is < DS_PREAMBLE_LENGTH, then pPreamble will be updated with a truncated version of the Preamble with length 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, Linux.

See Also

Functions:

L_DicomGetInfoDS, L_DicomGetCountValue

Topics:

Working with Data Sets

Example

This example gets the default preamble

L_INT DicomGetPreambleExample(L_VOID) 
{ 
   HDICOMDS hDS; 
   L_UCHAR   szPreamble[DS_PREAMBLE_LENGTH]; 
 
   hDS = L_DicomCreateDS(NULL); 
   L_DicomGetPreamble(hDS, szPreamble, sizeof(szPreamble)); 
   L_DicomFreeDS(hDS); 
 
   return DICOM_SUCCESS; 
} 

Help Version 20.0.2019.3.12
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2019 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS DICOM C API Help