L_DicomCreateNet

#include "ltdic.h"

L_LTDIC_API HDICOMNET L_DicomCreateNet(pszPath, nMode)

L_TCHAR * pszPath;

/* character string */

L_INT32 nMode;

/* initialization mode */

Allocates memory for the network structure and sets the site of the temporary files. This function is available in the Medical Imaging Suite Toolkit.

Parameter

Description

pszPath

Character string containing the location of the temporary files. DICOM uses temporary files during the course of creating a file. If this parameter is NULL, the DICOM temporary files are kept in the directory Windows places its own temporary files. If this parameter is not NULL, the temporary files are placed in the specified directory.

nMode

Flag that indicates the security mode to use when initializing the network structure. Possible values are:

 

Value

Meaning

 

DICOM_SECURE_NONE

No security mode.

 

DICOM_SECURE_ISCL

Integrated Secure Communication Layer protocol security.

 

DICOM_SECURE_TLS

Transport Layer Secure protocol security.

Returns

A DICOM Network handle.

Comments

The allocated memory is freed by calling L_DicomFreeNet.

The LEADTOOLS DICOM DLL should be initialized before calling any DICOM Communication operations function. To initialize the DLL call L_DicomStartUp.

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_DicomFreeNet, L_DicomStartUp

Topics:

Working with DICOM Network Connections

Example

L_INT DicomCreateNetExample(L_VOID)
{
   /* This example constructs and destroys a Network class     */
   /* This example initializes and shutdown the network system */
   L_INT nRet;
   HDICOMNET hNet=NULL;
   
   /* start the network */
   nRet = L_DicomStartUp();
   if (nRet != DICOM_SUCCESS)
      return nRet;

   /* set the temporary file path */
   hNet = L_DicomCreateNet(TEXT("%UserProfile%\\My Documents\\LEADTOOLS Images\\Temp"), DICOM_SECURE_ISCL);

   if(nRet == DICOM_SUCCESS)
      MessageBox(NULL, TEXT("StartUp() Successful"), TEXT("Test"), MB_OK);
   else
      MessageBox(NULL, TEXT("StartUp() Failed"), TEXT("Test"), MB_OK);

   /* Initialization of other secure parameters, if necessary */

   /*
      do some network communication here
   */
   /* ... */
   
   /* Free the object */
   L_DicomFreeNet(hNet);

   /* shut down the network */
   L_DicomShutDown();

   return DICOM_SUCCESS;
}