L_DicomDirSetFileSetID

#include "ltdic.h"

L_LTDIC_API L_UINT16 L_DicomDirSetFileSetID(hDicomDir, pszFileSetID)

Sets the identifier of the file-set for which the Dicom Directory is created.

Parameters

HDICOMDIR hDicomDir

A DICOMDIR handle

L_TCHAR *pszFileSetID

Character string that contains the ID of the file-set.

Returns

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

Comments

This function sets the value of the File-set ID (0004,1130) element. Since the VR of this element is CS (Code String), the identifier of the File-set should not exceed 16 characters. The allowed characters are the uppercase characters, "0" "9", the SPACE character, and the underscore "_", of the Default Character Repertoire.

The identifier of a file-set provides a simple, human-readable reference. However, the identifier might not be globally unique. For example, a File-set ID can be set to be identical to a disk label.