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

Platforms

Win32, x64

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