SetCallAnswerTimeout

 

The SetCallAnswerTimeout function allows you to specify the time that must elapse in order for the media engine to ignore an incoming phone call. After the specified time interval has elapsed for the incoming phone call, the media engine will terminate incoming ring and ignore the call.

 

 

TELEPHONY_RETURN_VALUE SetCallAnswerTimeout(

SIPHANDLE hStateMachine,

DWORD CallAnswerTimeoutSeconds

);

 

 

 

Parameters:

 

hStateMachine

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

 

CallAnswerTimeoutSeconds

[in] The call answer time out value in seconds. If your application software does not call this API procedure, the media engine will use an internal default value of 60 seconds for call answer time outs.

 

 

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.

 

SipCallFailure

The time out value specified is too large. The largest value that can be specified is (2^32)/1000 seconds.