|
lineDeallocateCall
The lineDeallocateCall function deallocates the specified call handle.
LONG lineDeallocateCall(
Parameters
hCall
The call handle to be deallocated. An application with monitoring privileges
for a call can always deallocate its handle for that call. An application with
owner privilege for a call can deallocate its handle except when the application
is the sole owner of the call and the call is not in the idle state. The call handle is no longer valid after it has been deallocated.
Return Values
Returns zero if the request is successful or a negative error number if an
error has occurred. Possible return values are:
LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE,
LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.
Remarks
The deallocation does not affect the call state of the physical call. It does,
however, release internal resources related to the call.
In API versions less than 0x00020000, if the application is the sole owner of
a call and the call is not in the idle state, LINEERR_INVALCALLSTATE is returned. In this case, the application can
first drop the call using lineDrop and deallocate its call handle afterwards. An application that has monitor
privilege for a call can always deallocate its handle for the call.
In API versions 0x0002000 and greater, the sole owner of the call can deallocate its handle even though the call is not in the idle state. (This allows for distributed control of the call in a client/server
environment.) Be aware that leaving the call without an owner may result in the
user being unable to terminate the call if there are monitoring applications
open preventing TAPI from calling TSPI_lineCloseCall. Use this feature only if the application can determine that the call can be
controlled externally by the user (see LINEADDRCAPFLAGS_CLOSEDROP).
In API versions less than 0x00020000, when the lineDeallocateCall function deallocates a call handle, it also suspends further processing of
any outstanding LINE_REPLY messages for the call. An application must be designed not to wait indefinitely for LINE_REPLY messages for each corresponding call to
an asynchronous function if it also uses the lineDeallocateCall function to deallocate handles.
In API versions 0x0002000 and greater, lineDeallocateCall does not suspend outstanding LINE_REPLY messages; every asynchronous function
that returns a dwRequestID to the application always results in the delivery of the associated
LINE_REPLY message unless the application calls lineShutdown.
See Also
LINE_REPLY, lineDrop, lineShutdown
| Last news from Greatis Software |
 |
|
Nostalgia .Net |
|
.Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More » |
| Recommended software for developers |
 |
|
Ultimate Pack |
|
Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More » |
 |
|
Form Designer .Net |
|
Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More » |
 |
|
Print Suite .Net |
|
Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More » |
 |
|
Gradient Controls .Net |
|
Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More » |
 |
|
Greatis iGrid |
|
iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More » |
All the contacts and projectsDmitry Vasiliev (just.dmitry)
Related LinksSoftware for Visual Studio .NET developers
Software for Delphi and C++ Builder developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET More Online Helps Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages
|
