Instructs the current protocol to stop blocking calls.

Note: This function and all other ADI call control functions have been superseded by the NCC service. For more information, see the Natural Call Control Service Developer's Reference Manual.

DWORD adiUnBlockCalls ( CTAHD ctahd )

ctahd CTA context handle returned by ctaCreateContext.

• SUCCESS
• CTAERR_INVALID_CTAHD
• CTAERR_INVALID_STATE
• CTAERR_FUNCTION_NOT_ACTIVE
  This error is returned when a function call is made to ADI call control when the NCC service is active.

• ADIEVN_CALLS_UNBLOCKED

This function instructs the current protocol to stop blocking calls. When adiBlockCalls is called, a transition to the blocking state occurs and calls are blocked. adiUnBlockCalls is called to exit this state, which results in a transition from the blocking state to the Idle state. When this transition occurs, the ADI service generates the event ADIEVN_CALLS_UNBLOCKED. This transition may be deferred until the remote end goes on-hook.

Once the CTA context enters the Idle state, it can receive or place new calls.

If adiBlockCalls is called and adiUnBlockCalls is called before the protocol is able to start blocking calls, no event is received. For more information about controlling calls under specific TCPs, refer to the AG CAS for Natural Call Control Installation and Developer's Manual and to the AG CAS for the ADI Service Installation and Developer's Manual.

Note: This function is not available when using the NOCC protocol.

adiBlockCalls

int myUnBlockCalls( CTAHD ctahd )
{
 CTA_EVENT event;

    if( adiUnBlockCalls( ctahd ) != SUCCESS )
        return MYFAILURE;

    do 

    {
        myGetEvent( &event );           /* see ctaWaitEvent example */
        switch( event.id )
            {
            /* ... */
            }
    } while( event.id != ADIEVN_CALLS_UNBLOCKED );
    return SUCCESS;
}