L_DicomSetDefaultDicomTempPath

Summary

Sets the global default location of the temporary files used by HDICOMDS and HDICOMNET objects.

Syntax

L_LTDIC_API L_VOID L_DicomSetDefaultDicomTempPath(szPath)

Parameters

L_TCHAR *szPath

A character string containing the global default location of the temporary files to set.

Returns

None.

Comments

The default location for HDICOMDS and HDICOMNET temporary files is chosen by Windows.

This behavior is modified by calling L_DicomSetDefaultDicomTempPath:

• Calling L_DicomSetDefaultDicomTempPath with a non-empty path uses this path for DICOM temporary files instead of the Windows temporary file location.

• Calling L_DicomSetDefaultDicomTempPath with an empty string or NULL causes Windows to choose the DICOM temporary file location.

Note that this behavior can be overridden for individual objects by specifying a temporary file location as the first argument when constructing a HDICOMDS or HDICOMNET object:

• L_DicomCreateDS(pszPath)
• L_DicomCreateNet(pszPath,nMode)

Passing an existing path for the first argument causes the DICOM temporary files to be created in this location.

Passing an empty string or NULL for the first argument causes the path returned by L_DicomGetDefaultDicomTempPath to be used for the DICOM temporary file location; if the path returned by L_DicomGetDefaultDicomTempPath is the empty string or NULL, Windows chooses the DICOM temporary file location.

If this function has not been called, L_DicomGetDefaultDicomTempPath will return NULL.

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

• L_DicomSetDefaultDicomTempPath
• L_DicomGetDefaultDicomTempPath
• L_DicomCreateNet(pszPath,nMode)
• L_DicomCreateDS(pszPath)

Topics

• Working with Data Sets
• Working with DICOM Network Connections