(Page 23 of 23 in this chapter) Version

nccUnblockCalls

Description

Release block on incoming calls.

Prototype

DWORD nccUnblockCalls ( CTAHD linehd,
void *unblockparms )
linehd NCC line handle.
unblockparms Pointer to protocol-specific CT Access call unblocking parameter structure. Protocol-independent applications can pass NULL for this argument to use the defaults. Also see protocol-specific documentation for details.

Return Values

SUCCESS
CTAERR_INVALID_HANDLE
NCC service is not opened on the specified CT Access handle.
CTAERR_INVALID_STATE
The specified line is not in the Blocking line state, and no previously invoked nccBlockCalls is pending.

Events

NCCEVN_CALLS_UNBLOCKED
The unblock calls request completed successfully. The line state has changed to Idle.
NCCEVN_UNBLOCK_FAILED
The request to unblock calls failed. The event value field contains the reason.

Details

This function cancels call blocking on the specified line handle. When the line state has changed to Idle, NCCEVN_CALLS_UNBLOCKED is generated. The application can then receive or place new calls.
nccUnblockCalls may be used to cancel a previous nccBlockCalls invocation before the protocol is able to start blocking calls on the specified line. In this case, the application receives no events.
If the request fails for some reason, the application receives NCCEVN_UNBLOCK_FAILED. The line remains in the current state.

See Also

nccBlockCalls

(Page 23 of 23 in this chapter) Version

tech_support@nmss.com

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