ms_delconf( )

---

Cautions | Errors | Example | See Also

Name:	int ms_delconf (devh, confID)
Inputs:	int devh	MSI board device handle
	int confID	conference identifier
Returns:	0 on success -1 on failure
Includes:	srllib.h dtilib.h msilib.h
Category:	Conference Management
Mode:	synchronous
Platform:	DI, Springware

Description

The ms_delconf( ) function deletes a conference previously established. The conference ID is the value previously returned by ms_estconf( ).

Parameter	Description
devh	the MSI board device handle
confID	the MSI conference identifier

Notes:

1. Calling this function frees all resources in use by the conference.
2. It is the responsibility of the application to perform an unlisten for each party of the conference.

Cautions

None.

Errors

If this function returns -1 to indicate failure, obtain the reason for the error by calling the SRL standard attribute function ATDV_LASTERR( ) or ATDV_ERRMSGP( ) to retrieve either the error code or a pointer to the error description, respectively.

Refer to the error type tables found in Chapter 5, "Error Codes". Error defines can be found in dtilib.h or msilib.h.

Example

#include <windows.h>         /* For Windows applications only */
#include <errno.h>
#include "srllib.h"
#include "dtilib.h"
#include "msilib.h"  
#define    NUM_PARTIES    3  
int  dev1;                   /* Board dev descriptor variables */
MS_CDT cdt[NUM_PARTIES];     /* Conf. desc. table */
int  confID;                 /* Conf. ID */  
/* Open board 1 device */
if ((dev1 = ms_open("msiB1",0)) == -1) {
    printf( "Cannot open MSI B1: errno=%d", errno);
    exit(1);
}  
/*
 * Continue processing
 */  
/* Set up CDT structure */
/* station 2, 4 and 7 are used to establish a conference */
cdt[0].chan_num = 2;
cdt[0].chan_sel = MSPN_STATION;
cdt[0].chan_attr = MSPA_NULL;  
cdt[1].chan_num = 4;
cdt[1].chan_sel = MSPN_STATION;
cdt[1].chan_attr = MSPA_PUPIL;  
cdt[2].chan_num = 7;
cdt[2].chan_sel = MSPN_STATION;
cdt[2].chan_attr = MSPA_COACH;  
/* Establish conference */
if (ms_estconf(dev1, cdt, NUM_PARTIES, MSCA_ND, &confID) != 0) {
    printf("Error Message = %s",ATDV_ERRMSGP(dev1));
    exit(1);
}  
/*
 * Continue processing
 */  
if (ms_delconf(dev1, confID) == -1){
    printf("Error Message = %s",ATDV_ERRMSGP(dev1));
    exit(1);
} 
/* Continue processing */  

See Also

• ms_addtoconf( )
• ms_estconf( )
• ms_monconf( )
• ms_remfromconf( )
• ms_unmonconf( )

Click here to contact Telecom Support Resources