ms_SetMsgWaitInd( )

---

Cautions | Errors | Example | See Also

Name:	ms_SetMsgWaitInd (devh, IndicatorState, rfu1, rfu2)
Inputs:	int devh	station device handle
	unsigned short IndicatorState	indicator ON/OFF state
	void* rfu	reserved for future use
	void* rfu	reserved for future use
Returns:	0 on success -1 on failure
Includes:	srllib.h dtilib.h msilib.h
Category:	Station
Mode:	synchronous
Platform:	DI, HDSI

Description

The ms_SetMsgWaitInd( ) function generates an FSK signal to illuminate the message waiting LED.

Parameter	Description
devh	device handle
IndicatorState	toggles FSK message waiting indicator (MWI) on a phone set MS_MSGINDON turns the MWI on MS_MSGINDOFF turns the MWI off
rfu	reserved for future use
rfu	reserved for future use

Cautions

This function can only be issued when the station is on-hook.

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.

Possible errors for this function include:

First error code define

First error code meaning

Example

#include <windows.h>    /* For Windows application only */
#include <stdio.h>
#include <errno.h>
#include "srllib.h"
#include "dtilib.h"
#include "msilib.h" 
int dev1;        /* Station Device Descriptor    */
int rc;          /* Return Code                  */ 
unsigned short IndicatorState= MS_MSGINDON;
void *RFU1=0,*RFU2=0; 
/* Open board 1, Station 1 device */
if ( (dev1 = ms_open("msiB1C1", 0)) == -1) 
{
    printf("Cannot open msiB1C1, Station 1, Channel 1: errno=%d\n",errno);
    exit(1);
} 
/*
*    Continue processing
*/ 
/*    Set the Message Wait Indicator to ON    */
IndicatorState= MS_MSGINDON;
if((rc=ms_SetMsgWaitInd(dev1,IndicatorState,RFU1,RFU2))==-1)    
{
    /* process error    */
} 
/*
*    Continue processing
*/ 
/*    Set the Message Wait Indicator to OFF    */
IndicatorState= MS_MSGINDOFF;
if((rc=ms_SetMsgWaitInd(dev1,IndicatorState,RFU1,RFU2))==-1)    
{
    /* process error    */
} 
/*
*    Continue processing
*/ 
/* Done processing - close device */
if(ms_close(dev1)==-1)    
{
printf("Cannot close device msiB1C1. errno=%d\n",errno);
    exit(1);
} 

See Also

• ms_genringCallerID( )

Click here to contact Telecom Support Resources