Collapse All Expand All

LDicomDS::SetPreamble

#include "Ltdic.h"

L_VOID LDicomDS::SetPreamble(pPreamble, nLength)

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

Sets the contents of the preamble.

Parameter	Description
pPreamble	Character string that contains the preamble to set.
nLength	Length of pPreamble. The maximum length is DS_PREAMBLE_LENGTH, which is defined as 128.

Returns

None.

Comments

The standard length of the Preamble is 128 bytes. You may use the constant DS_PREAMBLE_LENGTH, which is defined as 128, when setting nLength.

If the value specified in nLength is > DS_PREAMBLE_LENGTH, then the Preamble will be set with the first 128 bytes of pPreamble. If nLength is <= DS_PREAMBLE_LENGTH, then the Preamble will be set with the entire contents of pPreamble.

To retrieve the contents of the Preamble, call LDicomDS::GetPreamble.

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::GetPreamble
Topics:	Working with Data Sets
	How to Disable the Automatic Loading of the default DICOM IOD Table

Example

This example sets the preamble.

L_INT LDicomDS_SetPreambleExample()
{
   LDicomDS*   pDS;
   L_UCHAR     szPreamble[DS_PREAMBLE_LENGTH];
   pDS = new LDicomDS(NULL);
   memset(szPreamble, 0xFF, sizeof(szPreamble));
   pDS->SetPreamble(szPreamble, sizeof(szPreamble));
   delete pDS;
   return DICOM_SUCCESS;
}