lineRedirect
The lineRedirect
function redirects the specified offering call to the specified destination
address.
LONG lineRedirect(
HCALL hCall, |
|
LPCSTR lpszDestAddress, |
|
DWORD dwCountryCode |
|
); |
|
Parameters
hCall
A handle to
the call to be redirected. The application must be an owner of the call. The
call state of hCall must be offering.
lpszDestAddress
A pointer to
the destination address. This follows the standard dialable number format.
dwCountryCode
The country
code of the party the call is redirected to. If a value of zero is specified, a
default is used by the implementation.
Return Values
Returns a
positive request ID if the function will be completed asynchronously, or a
negative error number if an error has occurred. The dwParam2 parameter
of the corresponding LINE_REPLY
LINEERR_INVALADDRESS,
LINEERR_NOTOWNER, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL,
LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALCOUNTRYCODE,
LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED,
LINEERR_NOMEM.
Remarks
Call
redirection allows an application to deflect an offering call to another
address without first answering the call. Call redirect differs from call
forwarding in that call forwarding is performed by the switch without the
involvement of the application; redirection can be done on a call-by-call basis
by the application, for example, driven by caller ID information. It differs
from call transfer in that transferring a call requires the call first be
answered.
After a call
has been successfully redirected, the call typically transitions to idle.
Besides
redirecting an incoming call, an application may have the option to accept the
call using lineAccept, reject the call using lineDrop, or answer
the call using lineAnswer. The availability of these operations is
dependent on device capabilities.
See Also