NWSendBroadcastMessage(3nw)

NWSendBroadcastMessage -- sends broadcast message to logical connections on NetWare server

Synopsis

   #include <nwmsg.h> 
   or 
   #include <nwcalls.h> 
    
   NWCCODE N_API NWSendBroadcastMessage 
     (NWCONN_HANDLE   conn, 
      pnstr8          message, 
      nuint16         connCount, 
      pnuint16        connList, 
      pnuint8         resultList);

Description

The parameters are as follows:

conn: (IN) Specifies the NetWare server connection handle.
message: (IN) Points to the NULL-terminated message being sent.
connCount: (IN) Specifies the number of connections in the connection list.
connList: (IN) Points to an array containing the connection numbers of all stations scheduled to receive the message.
resultList: (OUT) Points to an array containing result codes for all stations being sent the broadcast.

Return values

0x0000: SUCCESSFUL
0x8801: INVALID_CONNECTION
0x89FC: MESSAGE_QUEUE_FULL
0x89FD: BAD_STATION_NUMBER
0x89FF: Failure

Notices

NWSendBroadcastMessage can be used by any client. The specified NetWare server attempts to store the broadcast message in the message buffer of each target connection. A result code for each target is returned by NWSendBroadcastMessage in resultList. Valid result codes are listed below:

0x0000: Successful. NetWare server stored the message in the target connection's message buffer.
0x0001: (4.0 only) Illegal station number; station number (conn) is invalid.
0x0002: (4.0 only) Client not logged in; intended recipient of the message is not currently logged in to the default server, even though the client may be logged in to the network.
0x0003: (4.0 only) Client not accepting message; intended recipient of message not accepting incoming messages.
0x0004: (4.0 only) Client already has message; server already has a message stored for intended recipient and cannot accept another message until that recipient clears the message from their screen.
0x0150: (4.0 only) No allocation of space for the message on the server; message cannot be sent.

These result codes indicate whether the NetWare server has successfully placed the message in the message buffer of the target connection. The NetWare server notifies the connection when a message arrives. However, placing the message in the message buffer and notifying the connection does not guarantee that the target station received the message. It is the target's responsibility to retrieve and display the message, depending on the broadcast mode of the connection.

A broadcast message can have the following sizes:

before 3.11: 1-58 bytes
3.11 and later: 1-254 bytes

A broadcast can be sent to the following maximum number of configured connections:

before 3.11: 1-256
3.11 and later: 1-62

Messages longer than the appropriate buffer size are truncated. The broadcasting workstation does not receive a message regarding truncated broadcasts.

Services

Message

NCP calls

0x2222 21 00 Send Personal Message (3.11a or below)

0x2222 21 10 Send Personal Message (3.11b or above)

0x2222 23 17 Get File Server Information

 
 0x2222   21   00   Send Personal 
                    Message (3.11a 
                    or below) 
 0x2222   21   10   Send Personal 
                    Message (3.11b 
                    or above) 
 0x2222   23   17   Get File Server 
                    Information

0x2222	21	00	Send Personal Message (3.11a or below)
0x2222	21	10	Send Personal Message (3.11b or above)
0x2222	23	17	Get File Server Information