SetInboundInviteAckTimeout

 

The SetInboundInviteAckTimeout function allows an application to specify the number of milliseconds to wait for the final SIP ACK response to be received from the far end of an incoming call. Normally an application does not have to call this procedure unless you are having problems connecting incoming calls. If the final ACK for the inbound call is not received, the call will not connect unless you have configured the VOIP Media Engine to ignore the reception of final ACKs using the ConnectIncomingCallWithoutInviteAck API procedure.


 

TELEPHONY_RETURN_VALUE SetInboundInviteAckTimeout(

SIPHANDLE hStateMachine,

DWORD InboundInviteAckTimeoutMs

);
 

 

 

Parameters:

 

hStateMachine

[in] The handle to the telephony engine. This is the handle that was returned by a previous call to the StartSipTelephony procedure.

 

InboundInviteAckTimeoutMs

[in] The number of milliseconds to wait for an incoming invite ACK response for the incoming call. Any value 2000 Ms or greater is acceptable.

 

 

 

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 TELEPHONY_RETURN_VALUE data type.

 

 

 

Value

Description

SipInvalidHandle

An API procedure was passed an invalid handle. The telephony engine attempts to verify user specified telephony handles and returns this error when an invalid handle is detected.