Stops the dial operation.

DWORD adiStopDial( CTAHD ctahd )

ctahd Context handle returned by adiOpenPort.

• SUCCESS
• CTAERR_INVALID_CTAHD
• CTAERR_FUNCTION_NOT_ACTIVE
• CTAERR_INVALID_SEQUENCE
• CTAERR_INVALID_STATE

• ADIEVN_DIAL_DONE
  Once the dial operation has been stopped, AG Access 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 )
{
    ADI_EVENT event;

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

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

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

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