NWSendBroadcastMessage

Allows a client to send a broadcast message to the specified logical connections on the specified NetWare server

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.11, 3.12, 3.2, 4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:Message

Syntax

C

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

Delphi

  uses calwin32 
   
  Function NWSendBroadcastMessage 
    (conn : NWCONN_HANDLE; 
     message : pnstr8; 
     connCount : nuint16; 
     connList : pnuint16; 
     resultList : pnuint8 
  ) : NWCCODE;

Parameters

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

These are common return values; see Return Values (Return Values for C) for more information.

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x890A

NLM_INVALID_CONNECTION

0x89FB

INVALID_PARAMETERS

0x89FC

MESSAGE_QUEUE_FULL

0x89FD

BAD_STATION_NUMBER

Remarks

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:

Result code

Description

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

0x0096

(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-250 bytes

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

  before 3.11        1-200 
  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.

NCP Calls