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

See Also

Functions:

LDicomDS::GetInfoDS, LDicomDS::GetCountValue

Topics:

Working with Data Sets

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