L_DicomLoadXmlIOD

#include "Ltdic.h"

L_LTDIC_API L_UINT16 L_DicomLoadXmlIOD(pszFile, uFlags)

L_TCHAR *pszFile;

/* character string that contains the name of the XML file containing the IODs to load.*/

L_UINT uFlags;

/* reserved for future use */

Loads the IODs contained in the pszFile into the internal DICOM IOD Table.

Parameter

Description

pszFile

Character string that contains the name of the XML file containing the IODs to load.

uFlags

Reserved for future use. Pass 0.

Returns

DICOM_SUCCESS

The function was successful.

>0

An error occurred. Refer to Return Codes.

Comments

Quickly and easily customize the DICOM Information Object Definition table (IOD Table) by editing the dicTableIodModule file that is found in the LEADTOOLS Sample Images folder.  The dicTableIodModule.xml file is a human-readable XML file that lists all of the DICOM IODs and DICOM Modules currently defined in the DICOM Specification.  You can edit this with any text editor (for example,. notepad) to add or remove DICOM IODs. Then call L_DicomLoadXmlIOD() and pass the full path of the dicTableIodModule.xml  file. Note that calling L_DicomLoadXmlIOD() will first remove all IODs that are already present in the table.

To see the default values for the IOD Table, refer to the Default IOD Table.

For more information, see the topic Working with DICOM Tables.

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:

L_DicomInsertIOD

L_DicomDeleteIOD

L_DicomResetIOD

L_DicomDefaultIOD

Topics:

Working with Unique Identifiers

Working with DICOM Tables

Example

This example loads the DICOM IOD table from the dicTableIodModule.xml file that is shipped with the toolkit.

L_INT DicomLoadXmlIODExample(L_VOID)
{
   L_DicomLoadXmlIOD(TEXT("C:\\Users\\Public\\Documents\\LEADTOOLS Images\\dicTableIodModule.xml"), 0);
   return DICOM_SUCCESS;
}