Share via


LINECALLREASON

These bit-flag constants describe the reason for a call.

The following table shows the LINECALLREASON constants.

Value Decription
LINECALLREASON_CALLCOMPLETION = 0x00000080 The call was the result of a call completion request.
LINECALLREASON_CAMPEDON = 0x00004000 The call was camped on the address. Usually, it appears initially in the onhold state, and can be switched to using lineSwapHold. If an active call becomes idle, the camped-on call may change to the offering state and the device start ringing. TAPI version 2.0 and later.
LINECALLREASON_DIRECT = 0x00000001 This is a direct incoming or outgoing call.
LINECALLREASON_FWDBUSY = 0x00000002 This call was forwarded from another extension that was busy at the time of the call.
LINECALLREASON_FWDNOANSWER = 0x00000004 The call was forwarded from another extension that didn't answer the call after some number of rings.
LINECALLREASON_FWDUNCOND = 0x00000008 The call was forwarded unconditionally from another number.
LINECALLREASON_INTRUDE = 0x00001000 The call intruded onto the line, either by a call completion action invoked by another station or by operator action. Depending on switch implementation, the call may appear either in the connected state, or conferenced with an existing active call on the line. TAPI version 1.4 and later.
LINECALLREASON_PARKED = 0x000002000 The call was parked on the address. Usually, it appears initially in the onhold state. TAPI version 1.4 and later.
LINECALLREASON_PICKUP = 0x00000010 The call was picked up from another extension.
LINECALLREASON_REDIRECT = 0x00000040 The call was redirected to this station.
LINECALLREASON_REMINDER = 0x00000200 The call is a reminder, or "recall", that the user has a call parked or on hold for potentially a long time.
LINECALLREASON_ROUTEREQUEST = 0x00008000 The call appears on the address because the switch needs routing instructions from the application. The application should examine the CalledID member in LINECALLINFO, and use the lineRedirect function to provide a new dialable address for the call. If the call is to be blocked instead, the application may call lineDrop. If the application fails to take action within a switch-defined timeout period, a default action will be taken. A service provider can use this constant only if the negotiated version on the line is 2.0 or higher. Otherwise the service provider should substitute LINECALLREASON_UNAVAIL. TAPI version 2.0 and later.
LINECALLREASON_TRANSFER = 0x00000100 The call has been transferred from another number.
LINECALLREASON_UNAVAIL = 0x00000800 The reason for the call is unavailable and will not become known later.
LINECALLREASON_UNKNOWN = 0x00000400 The reason for the call is currently unknown but may become known later.
LINECALLREASON_UNPARK = 0x00000020 The call was retrieved as a parked call.

Remarks

These constants cannot be extended. All 32 bits are reserved.

The LINECALLREASON constants are used in the dwReason member of the LINECALLINFO data structure.

Requirements

OS Versions: Windows CE 3.0 and later.
Header: Tapi.h.

See Also

lineDrop | lineSwapHold | lineRedirect | LINECALLINFO

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.