Releases resources associated with a call in the disconnected state and destroys the call handle.
DWORD nccReleaseCall ( NCC_CALLHD callhd, void *releaseparms)
|
Argument |
Description |
|
callhd |
Handle of the call being released. |
|
releaseparms |
Pointer to protocol-specific NaturalAccess call release parameter structure. For a protocol-independent application using default parameters, pass NULL. See your protocol-specific documentation for details. |
|
Return value |
Description |
|
SUCCESS |
|
|
CTAERR_INVALID_HANDLE |
The call handle is not valid. It may have been released. |
|
CTAERR_INVALID_STATE |
The line is in uninitialized state. |
|
CTAERR_SVR_COMM |
A server communication error occurred. |
|
NCCERR_INVALID_CALL_STATE |
The call is not in the disconnected state. |
|
Event |
Description |
|
NCCEVN_CALL_RELEASED |
Generated after the protocol has performed the network procedures for releasing the call. All internal resources allocated to the call are released. After the application receives this event, no more DSP-related events are generated for this call handle. |
nccReleaseCall can only be called when a call is in the disconnected state. When a call is released, it is completely destroyed. The application can no longer retrieve call status information.