Remove listeners from a connection.

DWORD ppxRemoveListeners ( PPXHD ppxhd,
PPX_MVIP_ADDR listeners[],
unsigned count )

ppxhd Handle returned by ppxCreateConnection or by ppxOpenConnection.

listeners[] Pointer to a PPX_MVIP_ADDR structure. The structure is defined as follows:

typedef struct
{
 DWORD switch_number;
 DWORD bus;      
 DWORD stream;     
 DWORD timeslot;    
} PPX_MVIP_ADDR

See the Details section for a description of these fields.

count Number of listeners to remove.

• SUCCESS
• CTAERR_DRIVER_ERROR
  The underlying driver retrieved an unrecognized error. Call swiGetLastError to retrieve the MVIP device error code.
• CTAERR_INVALID_HANDLE
  ppxhd is not a valid connection handle.
• CTAERR_NOT_FOUND
  One of the listeners is not defined in the Point-to-Point Switching configuration file.
• CTAERR_OUT_OF_MEMORY
  Unable to allocate memory.
• PPXERR_COMM_FAILURE
  Problems were encountered when communicating with the PPX server.
• PPXERR_DRIVER_OPEN_FAILED
  The driver open failed, or the driver DLL or device was not found.
• PPXERR_INVALID_COUNT
  The number of supplied listeners is less than count.
• PPXERR_INVALID_SWITCH
  Switch number specified is inaccessible from the specified bus:stream:timelslot.
• PPXERR_NOT_CONNECTED
  One of the listeners is not receiving output on the connection.
• PPXERR_NOT_LISTENER
  One of the listeners is incapable of receiving output from the connection.
• SWIERR_INVALID_STREAM
  One or more of the streams specified is invalid.
• SWIERR_INVALID_TIMESLOT
  One or more of the timeslots specified is invalid.

• None.

This function removes listeners from a connection. Any unused intervening timeslots are freed, but the talker remains associated with the connection.

The PPX_MVIP_ADDR structure contains the following fields:

Field	Description
switch_number	Switch number of the board as defined in ppx.cfg
bus	Acceptable values are: MVIP95_MVIP_BUS MVIP95_LOCAL_BUS MVIP95_MC1_BUS
stream	The stream number of the listener.
timeslot	The timeslot of the listener.

ppxAddListeners, ppxCreateConnection, ppxOpenConnection

DWORD VoiceConx( CTAHD ctahd, MYCONTEXT *cust, BOOL make_conn )
{
    DWORD         ret;
    
    listeners[cust->id].stream = 1;
    listeners[cust->id].timeslot = cust->time_slot;        
    listeners[cust->id].switch_number = cust->swi ;
    listeners[cust->id].bus = MVIP95_LOCAL_BUS;
    
    if ( cust->conn_state == CTX_ONHOLD )
    {
       /*
        * If the caller had been put on hold, need to take them
        * off of hold before making the voice connection to the
        * Operator.
        */
 
       ppxRemoveListeners( ppxhd[HOLD_MSG], &listeners[cust->id], 1 );
    }

---

(Page 11 of 16 in this chapter)

---

tech_support@nmss.com

Copyright © 1999, Natural MicroSystems, Inc. All rights reserved.