LDicomDS::GetPreamble

#include "Ltdic.h"

L_VOID LDicomDS::GetPreamble(pPreamble, nLength)

L_UCHAR * pPreamble;	/* character string */
L_UINT16 nLength;	/* length of pPreamble */

Gets the contents of the files preamble.

Parameter	Description
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 LDicomDS::SetPreamble.

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

See Also

Functions:	LDicomDS::GetInfoDS, LDicomDS::GetCountValue
Topics:	Working with Data Sets
	How to Disable the Automatic Loading of the default DICOM IOD Table

Example

This example gets the default preamble.

L_INT LDicomDS_GetPreambleExample()
{
   LDicomDS*   pDS;
   L_UCHAR     szPreamble[DS_PREAMBLE_LENGTH];
   pDS = new LDicomDS(NULL);
   pDS->GetPreamble(szPreamble, sizeof(szPreamble));
   delete pDS;
   return DICOM_SUCCESS;
}