NWSendConsoleBroadcast

Broadcasts a 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 NWSendConsoleBroadcast ( 
     NWCONN_HANDLE       conn,  
     const nstr8 N_FAR  *message,  
     nuint16             connCount,  
     pnuint16            connList);
  

Delphi

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

Parameters

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

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

0x89C6

NO_CONSOLE_PRIVILEGES

0x89FD

BAD_STATION_NUMBER

Remarks

The requesting client must have operator rights to call NWSendConsoleBroadcast.

Messages are not received by workstations that have disabled broadcasts or workstations that are not logged in. If connCount is set to 0, the message is sent to all connections.

NCP Calls

See Also

NWSetBroadcastMode