LDicomDS::GetPreamble

#include "Ltdic.h"

L_VOID LDicomDS::GetPreamble(pPreamble, nLength)

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

Gets the contents of the file�s 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_VOID Test()
{
   LDicomDS *pDS;
   L_CHAR    szPreamble[DS_PREAMBLE_LENGTH];

   pDS = new LDicomDS(NULL);

   pDS->GetPreamble(szPreamble, sizeof(szPreamble));

   delete pDS;
}