Alert Functions - Win32 Programmer's Reference

Custom Search

Alert Functions

The alert functions notify network service programs and applications of network events. An event is a particular instance of a process or state of hardware as defined by an application. The alert functions allow applications to indicate when predefined events occur.

Other programs, network services, or internal network components use the NetAlertRaise function to raise an alert, notifying various applications or users when a particular type of event occurs. The Alert category functions, datatypes, structures, and constants are defined in the LMCONS.H, LMERR.H, and LMALERT.H header files. A source program can gain access to these definitions by defining the constants INCL_NETERRORS and INCL_NETALERT, and by including the header file LM.H.

The LMALERT.H include file defines the following classes of events for which alerts are sent out:

A network event requiring administrative assistance
An entry is added to an error log file
A user or application receives a broadcast message
A print job completes
A user accesses or uses certain applications or resources

You can define other classes of alerts for network applications as needed. For example, an application on a server routinely writes large amounts of data to a disk drive, running the risk of filling the disk. In this case, you might want the event ``no free disk space'' to trigger an alert that notifies the application to pause or terminate the process that is filling the disk.

An application or network service program, also known as a client, registers a request to be notified of an event (or class of events) by calling the NetAlertStart function. You can register the client for several types of events by calling the NetAlertStart function multiple times. Each registration adds an entry to an alert table. An application or network service program receives alert messages through the use of a mailslot (registered as \mailslot\name). If a program requires detailed information about an event, register it as a mailslot.

You can register an application or network service program for one type of event, or for several types, by calling the NetAlertStart function multiple times. For a registered application or network service program, use the NetAlertStop function to remove that application or network service program entry from the alert table for the particular class of event.

The alert functions are:

NetAlertRaise
NetAlertRaiseEx

The NetAlertRaise function is used to indicate that an event has occurred.

The fixed-length header contains the standard alert structure, STD_ALERT.

Additional information is included in the following structures:

ADMIN_OTHER_INFO
ERRLOG_OTHER_INFO
PRINT_OTHER_INFO
USER_OTHER_INFO

Last news from Greatis Software

    Nostalgia .Net     .Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More »

Recommended software for developers

    Ultimate Pack     Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More »

    Form Designer .Net     Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More »

    Print Suite .Net     Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More »

    Gradient Controls .Net     Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More »

    Greatis iGrid     iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More »

All the contacts and projects

Dmitry Vasiliev (just.dmitry)

More Online Helps

Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages

greatis just4fun network