lineUnpark
The lineUnpark
function retrieves the call parked at the specified address and returns a call
handle for it.
LONG lineUnpark(
|
HLINE hLine, |
|
|
DWORD dwAddressID, |
|
|
LPHCALL lphCall, |
|
|
LPCSTR lpszDestAddress |
|
|
); |
|
Parameters
hLine
A handle to
the open line device on which a call is to be unparked.
dwAddressID
The address
on hLine at which the unpark is to be originated.
lphCall
A pointer to
the location of type HCALL where the handle to the unparked call is returned.
This handle is unrelated to any other handle which might have been previously
associated with the retrieved call, such as the handle that might have been
associated with the call when it was originally parked. The application will be
the initial sole owner of this call.
lpszDestAddress
A pointer to
a NULL-terminated character buffer that contains the address where the call is
parked. The address is in standard dialable address format.
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 message is zero if the function is successful
or it is a negative error number if an error has occurred. Possible return
values are:
LINEERR_INVALADDRESS,
LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED,
LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER,
LINEERR_UNINITIALIZED, LINEERR_NOMEM.
See Also