(Page 3 of 23 in this chapter) Version

nccAnswerCall

Description

Answers an incoming call.

Prototype

DWORD nccAnswerCall ( NCC_CALLHD callhd,
unsigned num_rings,
void *answerparms)
callhd Call handle returned via NCCEVN_SEIZURE_DETECTED.
num_rings Number of rings to play before answering.
answerparms Pointer to protocol-specific CT Access call answering parameter structure. Specify NULL to use default values. See protocol-specific documentation for details.

Return Values

This event indicates that a call address or subaddress digit has been received from the network. The application may receive several of these events, as digits are received in an overlapped fashion for an incoming call. The value field contains the digit.

SUCCESS
CTAERR_INVALID_HANDLE
The call handle is not valid. It may have been released.
CTAERR_INVALID_STATE
Line is not in the appropriate state to invoke this function.
NCCERR_INVALID_CALL_STATE
Call is not in the appropriate state to invoke this function.

Events

NCCEVN_ANSWERING_CALL
The function has completed successfully and the call has entered the Answering call state.
NCCEVN_CALL_CONNECTED
The call is connected. The call enters the Connected call state.
NCCEVN_CALL_DISCONNECTED
The remote party has disconnected. The call enters the Disconnected call state.

Details

If this function completes successfully, the call enters the Answering call state. The application receives NCCEVN_ANSWERING_CALL. When the call is connected, the application receives NCCEVN_CALL_CONNECTED, and the call enters the Connected call state. If the remote party disconnects while the call is in the Answering call state, the application receives NCCEVN_CALL_DISCONNECTED.

See Also

nccAcceptCall, nccRejectCall

(Page 3 of 23 in this chapter) Version

tech_support@nmss.com

Copyright © 1999, Natural MicroSystems, Inc. All rights reserved.