L_DicomSetMaxCommBlockLengthISCL

#include "ltdic.h"

L_LTDIC_API L_UINT32 L_DicomSetMaxCommBlockLengthISCL(hNet, nCommBlockLength)

HDICOMNET hNet;

/* handle to an existing DICOM network */

L_UINT32 nCommBlockLength;

/* maximum communication block length */

Sets the maximum communication block length that can be sent/received by the current entity. This function is available in the Medical Imaging Suite toolkits.

Parameter

Description

hNet

Handle to an existing DICOM Network. This is the handle returned from the L_DicomCreateNet function.

nCommBlockLength

Size of the communication block length.

Returns

DICOM_SUCCESS

Success. The maximum communication block length was set. During mutual authentication, the client and server will agree to use the smaller communication block size of the two.

DICOM_ERROR

An error occurred. This usually occurs if the nCommBlockLength was too small for the maximum standard packet size (168 bytes). Refer to Return Codes.

Comments

An ISCL communication block contains a 32-byte header, followed by data, if data is included.

Please note that the size of the ISCL packets is 32 bytes larger than the communication block length, because of the header.

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_DicomCreateNet, L_DicomSetDefaultSigningISCL, L_DicomSetDefaultEncryptionISCL, L_DicomSetAuthDataISCL, L_DicomSetMaxMessageLengthISCL, L_DicomSetMutualAuthAlgISCL, L_DicomSetMutualAuthKeyISCL, L_DicomSetIndexForMutualAuthISCL, L_DicomSetEncryptKeyISCL, L_DicomSetIndexForEncryptISCL, L_DicomGetCommBlockLengthISCL

Topics:

DICOM Net: Communication block

 

Establishing an ISCL Line Connection

 

General Integrated Secure Communication Layer (ISCL) Information

Example

L_INT DicomSetMaxCommBlockLengthISCLExample(L_VOID)
{
   L_INT nRet;
   HDICOMNET hDicomNet;

   hDicomNet = L_DicomCreateNet (TEXT(""), DICOM_SECURE_ISCL);
   nRet = L_DicomSetMaxCommBlockLengthISCL(hDicomNet, 8160);

   // size of the blocks sent to network layer will be 8192 bytes (a 32-byte header is added)
   // other initializations
   return nRet;
}