NWSetBroadcastMode(3nw)


NWSetBroadcastMode -- sets message mode of requesting workstation

Synopsis

   #include <nwmsg.h> 
   or 
   #include <nwcalls.h> 
   

NWCCODE N_API NWSetBroadcastMode (NWCONN_HANDLE conn, nuint16 mode);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

mode
(IN) Specifies the broadcast mode to be set.

Return values

0x000
SUCCESSFUL

Notices

NWSetBroadcastMode can be used by any client.

When a broadcast message is sent, the NetWare server attempts to store the message in the message buffer of each target connection. The result of this action depends on the broadcast mode of the target station. The default mode is 0x00, receive all broadcasts. However, broadcast modes can be set to any one of the following by calling NWSetBroadcastMode:

Broadcast Mode Description
0x0000 Receive all broadcasts (default mode).
0x0001 Receive only server broadcasts. User messages are not stored.
0x0002 Disable all broadcasts. User messages are not stored. Server messages are stored but notification is not given to the workstation.
0x0003 Both user and server messages are stored but message notification is not sent to the workstation. The client can poll for messages.

 
 Broadcast Mode   Description 
 0x0000           Receive all broadcasts 
                  (default mode). 
 0x0001           Receive only server 
                  broadcasts. User messages 
                  are not stored. 
 0x0002           Disable all broadcasts. 
                  User messages are not 
                  stored. Server messages 
                  are stored but 
                  notification is not given 
                  to the workstation. 
 0x0003           Both user and server 
                  messages are stored but 
                  message notification is 
                  not sent to the 
                  workstation. The client 
                  can poll for messages. 


NOTE: When using Netx, NWCONN_HANDLE is ignored and NWBROADCAST_MODE is set for all logged-in connections.

Services

Message

NCP calls

0x2222 21 02 Disable Broadcasts
0x2222 21 03 Enable Broadcasts

 
 0x2222   21   02   Disable Broadcasts 
 0x2222   21   03   Enable Broadcasts 

References

NWSendConsoleBroadcast(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.