Stops the execution of a telephony protocol.

DWORD adiStopProtocol ( CTAHD ctahd )

ctahd CTA context handle returned by ctaCreateContext.

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

• ADIEVN_STOPPROTOCOL_DONE
  When the protocol has been halted, the ADI service generates a DONE event with the value field set to CTA_REASON_FINISHED.

This function stops a protocol previously started with adiStartProtocol.

You may stop the running protocol from any state. If the protocol is in the middle of a call, the call will be aborted (abnormally), the outgoing line signaling will be set to the ADI_CC_STATE_IDLE state, and the incoming signaling will be ignored.

All functions executing on the CTA context that require being in the connected state will be automatically terminated with CTA_REASON_RELEASED.

If an orderly shutdown is required, you can block calls (adiBlockCalls), and when receipt of an ADIEVN_CALLS_BLOCKED event indicates that the CTA context has entered the blocked state, you can then stop the protocol.

A new protocol may not be started until the DONE event is returned.

adiStartProtocol, adiBlockCalls

int myStopProtocol( CTAHD ctahd )
{
 CTA_EVENT event;

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

    while( 1 )
    {
        myGetEvent( &event );           /* see ctaWaitEvent example */

        switch( event.id )
        {
            case ADIEVN_STOPPROTOCOL_DONE:
                if( CTA_IS_ERROR( event.value ) )
                    return MYFAILURE;       /* API error */
                else
                    return SUCCESS;         /* stopped normally */
                break;
        }
    }
}