Answers a call.
DWORD nccAnswerCall ( NCC_CALLHD callhd, unsigned num_rings, void *answerparms)
|
Argument |
Description |
|
callhd |
Handle of the incoming call. |
|
num_rings |
Number of rings to play before answering. |
|
answerparms |
Pointer to a protocol-specific NaturalAccess call answering parameter structure. Specify NULL to use the default values. See the protocol-specific documentation for details. |
|
Return value |
Description |
|
SUCCESS |
|
|
CTAERR_INVALID_HANDLE |
The call handle is not valid. It may have been released. |
|
CTAERR_INVALID_STATE |
The line is not in the appropriate state to invoke this function. |
|
CTAERR_SVR_COMM |
A server communication error occurred. |
|
NCCERR_INVALID_CALL_STATE |
The call is not in the appropriate state to invoke this function. |
|
Event |
Description |
|
NCCEVN_ANSWERING_CALL |
The function completed successfully and the call has entered the answering state. |
|
NCCEVN_CALL_CONNECTED |
The call was connected. The call enters the connected state. |
|
NCCEVN_CALL_DISCONNECTED |
The remote party disconnected. The call enters the disconnected state. |
If nccAnswerCall is successful, the call enters the answering state. The application receives NCCEVN_ANSWERING_CALL. When the call is connected, the application receives NCCEVN_CALL_CONNECTED, and the call enters the connected state. If the remote party disconnects while the call is in the answering state, the application receives NCCEVN_CALL_DISCONNECTED.