Forward
Forwarding is the deflection of an incoming session to a different destination address. TAPI allows an application to specify a list of forwarding conditions for an address. Forwarding conditions can be as finely grained as a different destination and forwarding mode for each caller address.
The forwarding operation can also be used to implement a selective do-not-disturb feature, by forwarding some callers to voice mail and allowing others to attempt completion.
The forwarding operation can also cancel any forwarding currently in effect.
Some service providers require that an application create a consultation call prior to a forwarding operation. The forwarding operation is then passed a pointer to the consultation call.
Not all service providers support use of this operation.
TAPI 2.x: To set lineForward to get lineGetAddressStatus, change the LINE_ADDRESSSTATE notification message with LINEADDRESSSTATE_FORWARD.
TAPI 3.x: See ITAddress::Forward, ITAddress::get_CurrentForwardInfo, change notification: ITAddressEvent::get_Event with AE_FORWARD.
Note
It may be impossible for a service provider to know at all times what forwarding is in effect for an address. Forwarding can be canceled or changed in ways that do not result in notification to the service provider.