(Page 14 of 23 in this chapter) Version

nccReleaseCall

Description

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

Prototype

DWORD nccReleaseCall ( NCC_CALLHD callhd,
void *releaseparms)
callhd Call handle in Disconnected state.
releaseparms Pointer to protocol-specific CT Access call release parameter structure. For a protocol-independent application using default parameters, pass NULL. See protocol-specific documentation for details.

Return Values

SUCCESS
CTAERR_INVALID_HANDLE
The call handle is not valid. It may have been released.
CTAERR_INVALID_STATE
Line is in Uninitialized line state.
NCCERR_INVALID_CALL_STATE
Call is not in the Disconnected call state.

Events

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

This function 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

(Page 14 of 23 in this chapter) Version

tech_support@nmss.com

Copyright © 1999, Natural MicroSystems, Inc. All rights reserved.