In This Topic ▼

L_DicomInitializeNet

Summary

This function is to be used in conjunction with the L_DicomCreateNetExt function in order to change security options from the defaults. This function is available in the Medical Imaging Suite toolkits.

Syntax

#include "ltdic.h"

L_LTDIC_API L_INT L_DicomInitializeNet(hNet, pszPath, nMode, pCtxCreate)

Parameters

HDICOMNET hNet

A DICOM Network handle.

L_TCHAR *pszPath

Character string that contains the location of the temporary files.

L_INT32 nMode

Flag that indicates the security mode to use when initializing the network structure. This should be the same flag that was used in the L_DicomCreateNetExt function. Possible values are:

Value	Meaning
DICOM_SECURE_NONE	No security mode.
DICOM_SECURE_ISCL	Integrated Secure Communication Layer security mode.
DICOM_SECURE_TLS	Transport Layer Security security mode.

pL_SSL_CTX_CREATE pCtxCreate

Pointer to the L_SSL_CTX_CREATE structure that is used to modify the security defaults. This structure is used only if the nMode flag is DICOM_SECURE_TLS. Pass NULL to get the default values.

Returns

Value	Meaning
SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

This function is to be used in conjunction with the L_DicomCreateNetExt function when changing security options from the defaults. Note that when using the L_DicomCreateNetExt function it is also necessary to call L_DicomInitializeNet in order to prepare the DICOMNET handle for use. Use the pCtxCreate parameter when the nMode flag is set to DICOM_SECURE_TLS.

Note that the following uses of the LDicomNet constructors are functionally equivalent:

hNET = L_DicomCreateNet(pszPath, nMode);

L_DicomCreateNetExt(pszPath, nMode, 0); 
 if (hNet)   
    L_DicomInitializeNet(pszPath, nMode, 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, Linux.