Query regarding to TAPI_lineForward()

Hi friends,

I have a query regarding to the TSPI_lineForward() of TAPI.

I m confused whether TSPI_lineForward() is used to set or cancel Call
Forward in the switch or it is used to forward the received call on the
address to the desired destination.

i.e., if the TSPI_lineForward() is called then it will set/cancel call
forward in the switch or if call forward is set on the address then on
receiving LINE_APPNEWCALL, the TAPI Application will call this function to
forward the received call on the desired destination?

secondly, when call forward or any other feature is set or cancelled from
switch then using which message TSP has to inform TAPI about it?

Thanks,
Mohit

Mohit,lineForward() will modify the forwarding in the PBX.

Mohit,
lineForward() will modify the forwarding in the PBX.
lineForward() is not used by an app on an already received call.

If an app want to redirect an already received call (in
LINECALLSTATE_OFFERING) it would use lineRedirect().


TSP needs to send LINE_ADDRESSSTATE message with LINEADDRESSSTATE_FORWARD.
On request via TSPI_lineGetAddressStatus() the TSP has to provide infos in
the forward members of LINEADDRESSSTATUS.

See my TAPI and TSPI FAQ:
Q: How do I use lineForward (how to set LINEFORWARDLIST, LINEFORWARD
structures) ?
http://www.i-b-a-m.de/Andreas_Marschall's_TAPI_and_TSPI_FAQ.htm#_Q:_How_do_13

--
Best Regards
Andreas Marschall
Microsoft MVP for TAPI / Windows SDK / Visual C++ 2003-2008
TAPI / TSP Developer and Tester
My TAPI and TSPI FAQ:
http://www.I-B-A-M.de/Andreas_Marschall's_TAPI_and_TSPI_FAQ.htm
My Toto® Tools (a collection of free, mostly TAPI related tools):
http://www.i-b-a-m.de/Andreas_Marschall's_Toto_Tools.htm
TAPI development around the world (Frappr! map):
http://www.frappr.com/TAPIaroundTheWorld
* Please post all messages and replies to the newsgroup so all may
* benefit from the discussion.  Private mail is usually not replied to.
* This posting is provided "AS IS" with no warranties, and confers no
rights.

Thnks Andreas,But still I have a query that what is the significance of

Thnks Andreas,

But still I have a query that what is the significance of htConsultCall and
lphdConsultCall parameters in TSPI_lineForward()?

These parameters are generally required to exchange the handle of the
consultation call between TPAI and TSP. If TSPI_lineForward() is not used to
forward the call at the time it received then why htConsultCall and
lphdConsultCall parameters are the part of TSPI_lineForward()?

Thanks
Mohit

Mohit, you are welcome.From MSDN:lphConsultCallPointer to an HCALL location.

Mohit, you are welcome.


From MSDN:

lphConsultCall
Pointer to an HCALL location. In some telephony environments, this location
is loaded with a handle to a consultation call that is used to consult the
party that is being forwarded to, and the application becomes the initial
sole owner of this call. This pointer must be valid even in environments
where call forwarding does not require a consultation call. This handle is
set to NULL if no consultation call is created.

htConsultCall
The TAPI handle to a new call, if such a call must be created by the service
provider. In some telephony environments, forwarding a call has the side
effect of creating a consultation call used to consult the party that is
being forwarded to. In such an environment, the service provider creates the
new consultation call and must save this value and use it in all subsequent
calls to the LINEEVENT procedure reporting events on the call. If no
consultation call is created, this value can be ignored by the service
provider.
lphdConsultCall
A pointer to an HDRVCALL representing the service provider's identifier for
the call. In telephony environments where forwarding a call has the side
effect of creating a consultation call used to consult the party that is
being forwarded to, the service provider must fill this location with its
handle for the call before this procedure returns. The service provider is
permitted to do callbacks regarding the new call before it returns from this
procedure. If no consultation call is created, the HDRVCALL must be left
NULL.

--
Best Regards
Andreas Marschall
Microsoft MVP for TAPI / Windows SDK / Visual C++ 2003-2008
TAPI / TSP Developer and Tester
My TAPI and TSPI FAQ:
http://www.I-B-A-M.de/Andreas_Marschall's_TAPI_and_TSPI_FAQ.htm
My Toto® Tools (a collection of free, mostly TAPI related tools):
http://www.i-b-a-m.de/Andreas_Marschall's_Toto_Tools.htm
TAPI development around the world (Frappr! map):
http://www.frappr.com/TAPIaroundTheWorld
* Please post all messages and replies to the newsgroup so all may
* benefit from the discussion.  Private mail is usually not replied to.
* This posting is provided "AS IS" with no warranties, and confers no
rights.