(Page 2 of 17 in this chapter) Version

dpnAcceptCall

Description

Accepts an incoming call.

Prototype

DWORD dpnAcceptCall ( CTAHD ctahd,
unsigned mode,
unsigned reserved )
ctahd CTA context handle returned by ctaCreateContext.
mode Not used.
reserved Not used.

Return Values

SUCCESS
DPNERR_INVALID_CALL_STATE
CTAERR_INVALID_CTAHD
CTAERR_INVALID_STATE

Events

DPNEVN_ACCEPTING_CALLGenerated when the DPNSS service enters the Accepting state in response to dpnAcceptCall.
DPNEVN_CALL_DISCONNECTEDGenerated if the remote party hangs up.

Extended arguments

DPNSIS_CLC_xxx
DPNSIS_CLI
DPNSIS_DIVERT_BSY
DPNSIS_DIVERT_IMM
DPNSIS_INTRUSION_ACK
DPNSIS_NSI
DPNSIS_TEXT
DPNSIS_TID

Details

After the DPNEVN_INCOMING_CALL event is delivered, the application must invoke dpnAcceptCall, dpnAnswerCall, or dpnRejectCall. dpnAcceptCall places the call in the Accepting state, in which DPNSS supplementary service messages can be exchanged before the application decides to answer or reject the call.
For more information about accepting, answering, or rejecting calls, see Section 4.4.

See Also

dpnAnswerCall, dpnRejectCall, dpnReleaseCall, dpnSetExtendedArgs

(Page 2 of 17 in this chapter) Version

tech_support@nmss.com

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