L_DicomInsertModule

#include "Ltdic.h"

L_LTDIC_API pDICOMMODULE L_DicomInsertModule(hDS, nModule, bOptional)

HDICOMDS hDS;	/* a DICOM handle */
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
hDS	A DICOM handle.
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:	L_DicomDeleteElement, L_DicomDeleteModule, L_DicomInsertElement, L_DicomResetDS
Topics:	Working with Data Sets

Example

This example inserts a module in Data Set

L_INT DicomInsertModuleExample(L_VOID)
{
   HDICOMDS     hDS;
   pDICOMMODULE pModule;

   hDS = L_DicomCreateDS(NULL);

   L_DicomInitDS(hDS, CLASS_CT_IMAGE_STORAGE, 0); 
   pModule = L_DicomInsertModule(hDS, MODULE_PATIENT_STUDY, TRUE);
   if (pModule == NULL)
   {
      L_DicomFreeDS(hDS);
      return DICOM_ERROR_MEMORY;
   }

   L_DicomFreeDS(hDS);
   return DICOM_SUCCESS;
}