RejectInvalidFileID property (ILEADDicomDir Interface)

VB.NET example

C# example

Visual Basic example

Visual C++ 6.0 example

 

Syntax

VARIANT_BOOL RejectInvalidFileID

Overview

Refer to Creating DICOM Directories.

Remarks

Indicates whether methods of the ILEADDicomDir interface, that take a file name as a parameter, will fail if an invalid File ID is used. Possible values are:

Value

Meaning

VARIANT_TRUE

Any method of the ILEADDicomDir interface that takes a file name as a parameter will fail if the number of components in the File ID exceeds 8, or if the number of characters in any component of the File ID exceeds 8. (The last case is possible only for the last component, since short file names are used for File IDs.)

VARIANT_FALSE

(Default) The methods of the ILEADDicomDir interface that take a file name as a parameter will not fail if an invalid File ID is used.

As an example, if the destination folder is specified as "C:\DICOM Images\", then the following filenames will be rejected if the RejectInvalidFileID property is set to VARIANT_TRUE:

"C:\DICOM Images\Sub1\Sub2\Sub3\Sub4\Sub5\Sub6\Sub7\Sub8\Brain"

"C:\DICOM Images\Patient 1\CT-10-Knee.dic"

The first filename is rejected because the number of components in the File ID exceeds 8 (there are 9 components, starting from "Sub1"). The second filename is rejected because the number of characters in the last component, which is the short format of "CT-10-Knee.dic" (e.g., "CT-10-~1.dic") exceeds 8. On the other hand, the following filenames will not be rejected:

"C:\DICOM Images\Sub1\Sub2\Sub3\Sub4\Sub5\Sub6\Sub7\Brain"

"C:\DICOM Images\ Patient 1\Knee.dic"

See Also

Elements:

InsertDicomFile method, InsertDicomDS method, SetDescriptorFile method

Topics:

DICOM Elements: DICOM Directories