Stops the dial operation.

DWORD adiStopDial ( CTAHD ctahd )

ctahd CTA context handle returned by ctaCreateContext.

• SUCCESS
• CTAERR_FUNCTION_NOT_ACTIVE
• CTAERR_INVALID_CTAHD
• CTAERR_INVALID_SEQUENCE
• CTAERR_INVALID_STATE

• ADIEVN_DIAL_DONE
  Once the dial operation has been stopped, the ADI service generates a DONE event with the value field set to CTA_REASON_STOPPED.

Stops the dial function started by adiStartDial.

The dial operation (and any other operation requiring voice output) cannot be restarted until the DONE event is received.

adiStartDial

int myStopDial( CTAHD ctahd )
{
 CTA_EVENT event;

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

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

        switch( event.id )
        {
            case ADIEVN_DIAL_DONE:
                if( event.value == CTA_REASON_RELEASED )
                    return MYDISCONNECT;    /* call has been terminated */
                else if( CTA_IS_ERROR( event.value ) )
                    return MYFAILURE;       /* API error */
                else
                    return SUCCESS;         /* stopped normally */
                break;

            /* might include cases to handle disconnect, DTMFs, etc. */
        }
    }
}