Disconnects a call that is connected to the network.
DWORD nccDisconnectCall ( NCC_CALLHD callhd, void* disconnectparms )
|
Argument |
Description |
|
callhd |
Handle of the call being disconnected. |
|
disconnectparms |
Pointer to a protocol-specific NaturalAccess call disconnect parameter structure. Specify NULL to use default values. See the 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 not in the appropriate state to invoke this function. |
|
CTAERR_SVR_COMM |
A server communication error occurred. |
|
NCCERR_INVALID_CALL_STATE |
The call is already in the disconnected state. |
|
Event |
Description |
|
NCCEVN_CALL_DISCONNECTED |
The disconnect operation completed successfully and the call entered the disconnected state. |
Use nccDisconnectCall to disconnect a connected call or to abandon outbound call placement.
The NCC_CAP_DISCONNECT_IN_ANY_STATE bit in the capabilitymask returned by nccQueryCapability determines in which states nccDisconnectCall can be invoked. If the bit is set, nccDisconnectCall can be invoked in any call state except disconnected. If the bit is cleared, nccDisconnectCall can only be invoked in the connected call state, and in outbound call states.
A disconnected call is no longer active. If no active calls exist on a line, the line state changes to idle.