NetAlertRaise

The NetAlertRaise function notifies all registered clients that a particular event occurred.

Security Requirements

No special group membership is required to successfully execute NetAlertRaise.

NET_API_STATUS NetAlertRaise(
  LPWSTR AlertEventName,  
  LPVOID Buffer,          
  DWORD BufferSize        
);
 

Parameters

AlertEventName

Pointer to a Unicode string that specifies the interrupting message to raise.

Buffer

Pointer to the data to be sent to the clients listening for this interrupting message. The data should consist of the STD_ALERT structure followed by any additional interrupting message data from the ADMIN_OTHER_INFO, ERRLOG_OTHER_INFO, PRINT_OTHER_INFO, and USER_OTHER_INFO data structures.

BufferSize

Specifies in bytes, the size of the buffer.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in lmalert.h.
  Import Library: Use netapi32.lib.

See Also

Networking (Net) Overview, Net Functions, NetAlertRaiseEx