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