L_DicomLoadXmlUID

Show in webframe

#include "Ltdic.h"

L_LTDIC_API L_UINT16 L_DicomLoadXmlUID(pszFile, uFlags)

L_TCHAR *pszFile;	/* Character string that contains the name of the XML file containing the UIDs to load.*/
L_UINT uFlags;	/* reserved for future use */

Loads the UIDs contained in the pszFile into the internal DICOM UID Table.

Parameter	Description
pszFile	Character string that contains the name of the XML file containing the UIDs 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

Starting in version 17.5 of the toolkit, you can easily and quickly customize the DICOM Unique Identifier table (UID Table) by editing the dicTableUid.xml file that is found in the LEADTOOLS Sample Images folder. The dicTableUid.xml file is a human-readable XML file that lists all of the DICOM UIDs currently defined in the DICOM Specification. You can edit this with any text editor (for example, notepad) to add or remove DICOM UIDs. Then call L_DicomLoadXmlUID() and pass the complete path of the dicTableUid.xml file. Note that calling L_DicomLoadXmlUID() will first remove all UIDs that are already present in the table.

To see the default values for the UID Table, refer to the Default UID 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:

Topics:

Working with Unique Identifiers

Working with DICOM Tables

Example

This example loads the UID table from the dicTableUid.xml file that is shipped with the toolkit.

L_INT DicomLoadXmlUIDExample(L_VOID)
{
   L_DicomLoadXmlUID(TEXT("C:\\Users\\Public\\Documents\\LEADTOOLS Images\\dicTableUid.xml"), 0);
   return DICOM_SUCCESS;
}