CA_TDM_Disconnect()

Purpose

Breaks an existing connection between two port sets via the TDM bus.

Libraries

Blueworx Voice Response library (libvae.a)

Custom Server library (libca.a)

Syntax

#include “CA_header.h”
int CA_TDM_Disconnect (
     cont TDM_DISCONNECT_ST *disconnect_parm_sp
);

Description

This subroutine breaks a connection between two port sets. The connection is identified by a connection_id which was returned from CA_TDM_Connect() at the time connection was established. The connection is broken only if the token matches the one which was specified when the connection was established.

Parameters

disconnect_parm_sp
A pointer to a TDM_DISCONNECT_ST input structure that is filled in as described in TDM_DISCONNECT_ST.

Return codes

0
Successful
-1
Unsuccessful (global error number CA_errno is set to indicate the error)

Error names

CA_ADAPTER_ERROR
An error was reported by a TDM adapter or adapter-specific software.
CA_HANGUP
The call owning this connection has ended.
CA_INV_ADDR
One of the parameters is an invalid pointer.
CA_INV_CONNECTION_ID
The connection_id parameter is not valid, or is not recognized as a current connection.
CA_INV_TOKEN
The supplied token did not match the one used when the connection was made.
CA_NOT_INIT
CA_Init() has not been called.
CA_TERMINATING
The custom server is terminating.
CA_TSLOT_NOT_READY
TDM connection management processes are not running or reported an error.

Related information

CA_TDM_Connect().