2.2.3.1.27 LINECALLREASON_Constants
The LINECALLREASON_Constants are bit-flag constants that describe the reason for a call.
Constant/value |
Description |
---|---|
LINECALLREASON_DIRECT 0x00000001 |
The call must be a direct incoming or outgoing call. |
LINECALLREASON_FWDBUSY 0x00000002 |
This call must be forwarded from another extension that was busy at the time of the call. |
LINECALLREASON_FWDNOANSWER 0x00000004 |
The call must be forwarded from another extension that did not answer the call after some number of rings. |
LINECALLREASON_FWDUNCOND 0x00000008 |
The call must be forwarded unconditionally from another number. |
LINECALLREASON_PICKUP 0x00000010 |
The call must be picked up from another extension. |
LINECALLREASON_UNPARK 0x00000020 |
The call must be retrieved as a parked call. |
LINECALLREASON_REDIRECT 0x00000040 |
The call must be redirected to this station. |
LINECALLREASON_CALLCOMPLETION 0x00000080 |
The call must be the result of a call completion request. |
LINECALLREASON_TRANSFER 0x00000100 |
The call must have been transferred from another number. |
LINECALLREASON_REMINDER 0x00000200 |
The call must be a reminder (or "recall") that the user has a call parked or on hold for (potentially) a long time. |
LINECALLREASON_UNKNOWN 0x00000400 |
The reason for the call must be currently unknown but can become known later. |
LINECALLREASON_UNAVAIL 0x00000800 |
The reason for the call must be unavailable and will not become known later. |
LINECALLREASON_INTRUDE 0x00001000 |
The call intruded onto the line either by a call completion action that was invoked by another station or by operator action. Depending on switch implementation, the call can appear either in the connected state or conferenced with an existing active call on the line. |
The following constants are present in TAPI versions 1.4, 2.0, 2.1, 2.2, 3.0, and 3.1:
Constant/value |
Description |
---|---|
LINECALLREASON_PARKED 0x00002000 |
The call must be parked on the address. Usually, it appears initially in the onHold state. |
The following constants are present in TAPI versions 2.0, 2.1, 2.2, 3.0, and 3.1:
Constant/value |
Description |
---|---|
LINECALLREASON_CAMPEDON 0x00004000 |
The call must be camped on the address. Usually, it appears initially in the onHold state and can be switched to using the SwapHold packet. If an active call becomes idle, the camped-on call can change to the offering state and the device starts ringing. |
LINECALLREASON_ROUTEREQUEST 0x00008000 |
The call appears on the address because the switch needs routing instructions from the application. The application examines the CalledID member in LINECALLINFO and use the Redirect packet to provide a new dialable address for the call. If the call is to be blocked instead, the application can send the Drop packet. If the application fails to take action within a switch-defined time-out period, a default action will be taken. The service provider is to substitute LINECALLREASON_UNAVAIL. |
No extensibility. All 32 bits are reserved.
The LINECALLREASON_Constants MUST be used in the dwReason member of the LINECALLINFO data structure.