NWBroadcastToConsole

Sends a message to the default server’s system console

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 NWBroadcastToConsole ( 
     NWCONN_HANDLE       conn,  
     const nstr8 N_FAR  *message);

Delphi

  uses calwin32 
   
  Function NWBroadcastToConsole 
    (conn : NWCONN_HANDLE; 
     const message : pnstr8 
  ) : NWCCODE;

Parameters

conn
(IN) Specifies the NetWare® server connection handle.
message
(IN) Points to the NULL-terminated message to be sent.

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

Remarks

Under NETX, if an invalid connection handle is passed to conn, NWBroadcastToConsole will return 0x0000. NETX will pick a default connection handle if the connection handle cannot be resolved.

The message is displayed in a single line on the console screen after the colon (:) prompt. Messages longer than 58 bytes are truncated without notifying the broadcasting workstation. New messages overwrite previous messages at the console.

NCP Calls