# nccDisconnectCall

Disconnects a call that is connected to the network.

#### Prototype

DWORD nccDisconnectCall ( NCC_CALLHD callhd, void* disconnectparms )

Argument | Description
callhd | Handle of the call being disconnected.
disconnectparms | Pointer to a protocol-specific Natural Access call disconnect parameter structure. Specify NULL to use default values. See the protocol-specific documentation for details.

#### Return values

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.

#### Events

Event | Description
NCCEVN_CALL_DISCONNECTED | The disconnect operation completed successfully and the call entered the disconnected state.

#### Details

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.

#### See also

nccReleaseCall