L_DicomDirReset

#include "ltdic.h"

L_LTDIC_API L_UINT16 L_DicomDirReset(hDicomDir, pszDICOMDIRDstFolder)

Removes the contents of the Directory and reinitializes it.

Parameters

HDICOMDIR hDicomDir

A DICOMDIR handle

L_TCHAR *pszDICOMDIRDstFolder

Character string that contains the name of an existing destination folder in which to save the DICOMDIR File.

Returns

Value	Meaning
0	The function was successful.
> 0	An error occurred. Refer to Return Codes.

Comments

When a DICOMDIR handle is created, the Dicom Directory, as specified by the handle, is empty. To revert to this case at any time, call the function L_DicomDirReset. If the same object is to be used to create the Dicom Directory of a new file-set, this function must be called first.

This function also sets the destination folder of the DICOMDIR File. Please note that although the function can be passed a NULL, no DICOM file can be added to the Dicom Directory unless this folder is specified.