# nccReleaseCall

Releases resources associated with a call in the disconnected state and destroys the call handle.

#### Prototype

DWORD nccReleaseCall ( NCC_CALLHD callhd, void *releaseparms)

Argument | Description
callhd | Handle of the call being released.
releaseparms | Pointer to protocol-specific Natural Access call release parameter structure. For a protocol-independent application using default parameters, pass NULL. See your 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 in uninitialized state.
CTAERR_SVR_COMM | A server communication error occurred.
NCCERR_INVALID_CALL_STATE | The call is not in the disconnected state.

#### Events

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.

#### Details

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.

#### See also

nccDisconnectCall