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