L_DicomSetMaxLength

#include "ltdic.h"

L_LTDIC_API L_INT L_DicomSetMaxLength(hPDU, bEnabled, nLength)

HDICOMPDU hPDU;

/* a DICOM Associate handle */

L_BOOL bEnabled;

/* flag that indicates whether to enable the max length */

L_UINT32 nLength;

/* maximum length */

Enables or disables the Maximum Length restriction for data transfer. It also sets the maximum length value if the restriction is enabled.

Parameter

Description

hPDU

A DICOM Associate handle.

bEnabled

Flag that indicates whether to enable or disable the Maximum Length restriction. Possible values are:

 

Value

Meaning

 

TRUE

Enable the Maximum Length restriction for data transfer.

 

FALSE

Disable the Maximum Length restriction for data transfer.

nLength

The maximum length value to set. This value is only valid if bEnabled is TRUE.

Returns

DICOM_SUCCESS

The function was successful.

>0

An error occurred. Refer to Return Codes.

Comments

If the Maximum Length restriction is enabled the Maximum Length must be 0, or >= 8 and it must be an even number (8, 10, 12, ).

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_DicomIsMaxLength, L_DicomGetMaxLength

Topics:

Working with DICOM Associate Connections

Example

For an example, refer to L_DicomIsMaxLength.