LDicomDir::SetDescriptorFile

Summary

Sets the descriptor file (non-DICOM file) used for comments related to the file-set for which the Dicom Directory is created.

Syntax

L_UINT16 LDicomDir::SetDescriptorFile(pszFileName, pszCharSet)

Parameters

L_TCHAR* pszFileName

Character string that contains the name of the file-set descriptor file.

L_TCHAR* pszCharSet

Character string that contains the name of the character set used in the descriptor file. For information on the possible character set names, refer to "Specific Character Set of File-set Descriptor File" (0004, 1142) element in the DICOM Standard.

Returns

Comments

This function sets the values of the File-set Descriptor File ID (0004,1141) and the Specific Character Set of File-set Descriptor File (0004,1142) elements. If the parameter pszCharSet is set to NULL, the latter element will be deleted (if it exists). If the parameter pszFileName is set to NULL, both elements will be deleted.

If the name of a descriptor file is to be specified, then before using this function, a destination folder must have been specified, either at construction time or later, using the function LDicomDir::ResetDicomDir. Otherwise, the function will fail.

The descriptor filename must refer to an existing file that resides in the destination folder or in a subfolder of the destination folder. Otherwise, the function will fail. Please notice that the filename passed to the function must specify the absolute path of the file, not the relative one.

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

• Class Members

Topics

• Creating DICOM Directories
• Dicom Directories

Example

For an example, refer to LDicomDir::InsertDicomDS.