(Page 6 of 23 in this chapter) Version

nccDisconnectCall

Description

Disconnects a call that is connected to the network.

Prototype

DWORD nccDisconnectCall ( NCC_CALLHD callhd,
void* disconnectparms )
callhd NCC call handle opened via ctaOpenServices.
disconnectparms Pointer to protocol-specific CT Access call disconnect parameter structure. Specify NULL to use default values. 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 not in the appropriate state to invoke this function.
NCCERR_INVALID_CALL_STATE
The call is already in the Disconnected call state.

Events

NCCEVN_CALL_DISCONNECTED
The disconnect operation has completed successfully and the call has entered the Disconnected call state.

Details

This function is used to disconnect a connected call. It may also be used to abandon outbound call placement.
The NCC_CAP_DISCONNECT_IN_ANY_STATE bit in the capabilitymask returned by nccQueryCapability determines in which states nccDisconnectCall may be invoked. If the bit is set, nccDisconnectCall may be invoked in any call state except Disconnected. If the bit is cleared, nccDisconnectCall may 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

(Page 6 of 23 in this chapter) Version

tech_support@nmss.com

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