InsertDicomDS method (ILEADDicomDir Interface)

VB.NET example

C# example

Visual Basic example

Visual C++ 6.0 example

 

Syntax

short InsertDicomDS(long hDicomDS, BSTR bstrFileName);

Overview

Refer to Creating DICOM Directories.

Remarks

Adds a DICOM Data Set to the Dicom Directory.

If the name of a DICOM file is to be specified, then before using this method, a destination folder must have been specified using the ResetDicomDir method. Otherwise, the method will fail.

The DICOM filename must refer to an existing file that resides in the destination folder or in a subfolder of the destination folder. Otherwise, the method will fail and the Data Set will not be added to the Dicom Directory. Please notice that the filename passed to the method must specify the absolute path of the file, not the relative one.

If the parameter bstrFileName is set to NULL, a Data Set can still be added, even if no destination folder is specified. (That is, if bstrFileName is set to NULL and the destination folder has not been set, a Data Set can still be added.) In this case, no DICOM file will be referenced for this Data Set (i.e., the corresponding Referenced File ID (0004,1500) will have an empty value).

See Also

Elements:

ResetDicomDir method, InsertDicomFile method

Topics:

DICOM Elements: DICOM Directories