NWSetBroadcastMode

Sets the message mode of the requesting workstation

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  NWSetBroadcastMode  ( 
     NWCONN_HANDLE   conn,  
     nuint16         mode);

Delphi

  uses calwin32 
   
  Function NWSetBroadcastMode 
    (conn : NWCONN_HANDLE; 
     mode : nuint16 
  ) : NWCCODE;

Parameters

conn
(IN) Specifies the NetWare server connection handle.
mode
(IN) Specifies the broadcast mode to be set.

Return Values

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

0x0000

SUCCESSFUL

0x8836

INVALID_PARAMETER

Remarks

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.

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

NCP Calls

See Also

NWSendConsoleBroadcast