LDicomDS::InsertModule

#include "Ltdic.h"

pDICOMMODULE LDicomDS::InsertModule(nModule, bOptional)

L_UINT32 nModule;	/* module constant */
L_BOOL bOptional;	/* flag that indicates which elements to insert */

Inserts a new module in the Data Set.

Parameter	Description
nModule	Module constant the indicates the module being inserted. For a list of default values, refer to IOD Module Constants.
bOptional	Flag that indicates which elements of the module to insert. Possible values are:
	Value	Meaning
	TRUE	Insert all elements of the specified module.
	FALSE	Insert only the mandatory elements of the specified module.

Returns

!NULL	A pointer to a DICOMMODULE structure containing the newly inserted item.
NULL	Not enough memory to insert the item.

Comments

LEAD controls the placement of the module in the Data Set.

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::DeleteElement, LDicomDS::DeleteModule, LDicomDS::InsertElement, LDicomDS::ResetDS
Topics:	Working with Data Sets
	How to Disable the Automatic Loading of the default DICOM IOD Table

Example

This example inserts a module in Data Set.

L_INT LDicomDS_InsertModuleExample()
{
   LDicomDS     * pDS;
   pDICOMMODULE   pModule;
   pDS = new LDicomDS(NULL);
   pDS->InitDS( CLASS_CT_IMAGE_STORAGE, 0); 
   pModule = pDS->InsertModule(MODULE_PATIENT_STUDY, TRUE);
   delete pDS;
   return DICOM_SUCCESS;
}