ms_unlisten( )

Description | Cautions | Example | Errors | See Also

Name:	int ms_unlisten(devh)
Inputs:	int devh	station handle
Returns:	0 on success
	-1 on failure
Includes:	srllib.h
	dtilib.h
	msilib.h
Category:	SCbus Routing
Mode:	asynchronous

Description

The ms_unlisten( ) function disconnects the receive of a station from an SCbus time slot.

Parameter	Description
devh:	The station device handle.

Cautions

This function fails when:

• An invalid station device handle is specified.
• The device is operating in PEB mode.

Example

#include     "srllib.h"  
#include     "dxxxlib.h"  
#include     "dtilib.h"  
int     chdev          /* Station device handle */  
/* Open board 1, channel 1 */  
if ((chdev = ms_open("msiB1C1",0)) == -1) {  
     printf("Cannot open channel msiB1C1. errno = %d", errno);  
     exit(1);  
}  
/* Disconnect receive of board 1, station 1 from all SCbus time slots */  
if (ms_unlisten(chdev) == -1) {  
     printf("Error message = %s",ATDV_ERRMSGP(chdev));  
     exit(1);  
}

Errors

When the function fails and returns a -1, the specific error code may be retrieved by calling the SRL standard attribute function ATDV_LASTERR( ) to obtain the error code. A more descriptive error message may be retrieved using the function ATDV_ERRMSGP( ).

See Also

• ms_listen( )

Click here to contact Dialogic Customer Engineering