The SetCallTerminateTimeout function allows an application to specify the number of milliseconds that must pass before a call terminate operation (call hang-up) is considered to be in the time-out state. Generally application software does not need to call this API procedure unless a call endpoint is taking a very long time responding to your applications call termination requests. The internal default value for call termination time-out is 2000 Ms.

Namespace:  LanScape
Assembly:  LMEVoipManaged (in LMEVoipManaged.dll) Version: 6.0.5226.26700

Syntax

C#
public VoipMediaEngine..::.TELEPHONY_RETURN_VALUE SetCallTerminateTimeout(
	uint CallTerminateTimeoutMs
)
Visual Basic (Declaration)
Public Function SetCallTerminateTimeout ( _
	CallTerminateTimeoutMs As UInteger _
) As VoipMediaEngine..::.TELEPHONY_RETURN_VALUE
Visual C++
public:
VoipMediaEngine..::.TELEPHONY_RETURN_VALUE SetCallTerminateTimeout(
	unsigned int CallTerminateTimeoutMs
)
J#
public VoipMediaEngine..::.TELEPHONY_RETURN_VALUE SetCallTerminateTimeout(
	UInt32 CallTerminateTimeoutMs
)

Parameters

CallTerminateTimeoutMs
Type: System..::.UInt32
The number of milliseconds to use when determining call terminate time-out state. Any value 0 Ms or greater is acceptable.
Note:
If you specify a time out value that is smaller than the time it takes the far end of a call to respond to the media engine's BYE requests, you will receive SipCallTimeOut return values from the TerminateCall(Int32, Boolean, UInt32) API procedure. If the media engine has many calls active and you want to terminate the media engine quickly, setting the value for the CallTerminateTimeoutMs parameter to zero and calling this API procedure before terminating the media engine will result in faster shutdown.

Return Value

If the function succeeds, the return value will be SipSuccess.

If the function fails, the return value will be one of the following values as specified by the VoipMediaEngine..::.TELEPHONY_RETURN_VALUE data type.

Return ValueDescription
SipInvalidHandle
Application software specified an invalid telephony handle in one of the API procedures. This usually indicates memory corruption on the part of application software.

(API return value)

Remarks

None.

See Also