Instructs the current protocol to stop blocking calls.

DWORD adiUnBlockCalls( CTAHD ctahd )

ctahd Context handle returned by adiOpenPort.

• SUCCESS
• CTAERR_INVALID_CTAHD
• CTAERR_INVALID_STATE

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, AG Access generates the event ADIEVN_CALLS_UNBLOCKED. This transition may be deferred until the remote end goes on-hook.

Once the 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.

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

adiBlockCalls

int myUnBlockCalls( CTAHD ctahd )
{
    ADI_EVENT event;

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

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

 

---

(Page 80 of 80 in this chapter)

---

Tech_Support@nmss.com

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