LDicomIOD::LoadXml

#include "Ltdic.h"

static L_UINT16 LDicomIOD::LoadXml(pszFile, uFlags)

L_TCHAR *pszFile;

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

L_UINT uFlags;

/* reserved for future use.  Pass 0. */

Loads the IODs and modules 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 and modules to load.

uFlags

Reserved for future use.  Pass 0.

Returns

0

DICOM_SUCCESS

>0

An error occurred. Refer to Return Codes.

Comments

Quickly and easily customize the DICOM Information Object Definition (IOD Table) by editing the dicTableIOD.xml 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 (i.e. notepad) to add or remove DICOM IODs. Then call LDicomIOD::LoadXml() and pass the full path of the dicTableIodModule.xml file.

Note that calling LoadXml() 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, refer to the Working with DICOM Tables topic.

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:

LDicomIOD::Insert, LDicomIOD::Delete, LDicomIOD::Reset, LDicomIOD::Default, Class Members

Topics:

Information Object Definitions: Searching the IOD Table

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 LDicomIOD_LoadXmlExample()
{
   LDicomIOD::LoadXml(TEXT("C:\\Users\\Public\\Documents\\LEADTOOLS Images\\dicTableIodModule.xml"), 0);
   return DICOM_SUCCESS;
}