DICOMDIROPTIONS

typedef struct tagDICOMDIROPTIONS 
{ 
   L_INT nSize; 
   L_BOOL bIncludeSubfolders; 
   L_UINT32 uFlags; 
} DICOMDIROPTIONS, * pDICOMDIROPTIONS; 

The DICOMDIROPTIONS structure contains information concerning the Dicom Directory options. It is used by the functions LDicomDir::SetOptions and LDicomDir::GetOptions to set and get the DICOM Directory options.

Members

nSize

Size of the structure. This must be set before passing the structure to the function LDicomDir::SetOptions.

bIncludeSubfolders

Specifies whether the function LDicomDir::InsertDicomFile should add the DICOM files in the subfolders of the destination folder (when the function is passed a NULL). Possible values are:

uFlags

Specifies flags that control the behavior of some functions. This can be set to 0 (the default value) or:

Comments

As an example, if the destination folder is specified as "C:\DICOM Images\", then the following filenames will be rejected if DICOMDIR_REJECT_INVALID_FILEID is specified:

"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") and because lower case letters and spaces are used. 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 and because lower case letters and spaces are used. 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"