The NetAlertRaise API notifies all clients registered as semaphores or mailslots in the alert table that a particular event has occurred. Semaphores are cleared, and mailslots are sent messages.
For mailslot clients, NetAlertRaise writes information from buf to clients registered as mailslots by calling the DosWriteMailslot API.
All semaphore clients must be created with the NoExclusive option set and must be called by a process that calls the DosMuxSemWait API on the semaphore. This procedure informs the process of the state transition of the semaphore.
Restrictions
A call to this API can be issued only from an OS/2 application to the local computer.
#include <netcons.h>
#include <alert.h>
NetAlertRaise(pAlertType, buf,
usBuflen, timeout); /* 16 bit */
Net32AlertRaise(pAlertType, buf,
ulBuflen, timeout); /* 32 bit */
Parameters
See Common Parameter Definitions for descriptions of parameters not defined here.
pAlertType
The following table lists the return codes most significant to this API.
(See API Return Codes for a complete
list of return codes.) 旼컴컴컴컴컴컴컴컴컴컴컴컴컴컴쩡컴컴컴쩡컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴커쿞YMBOLICCONSTANT
쿣ALUE쿘EANING �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� NERR_Success � 0 � No errors were encountered. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� ERROR_INVALID_PARAMETER � 87 � At least one parameter value is not
�
� � � valid. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� ERROR_INVALID_NAME � 123 � There is an incorrect character or �
� � � incorrectly formed file system name. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� NERR_NetNotStarted � 2102 � The redirector NETWKSTA.200 has not
�
� � � been started. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� NERR_ShareMem � 2104 � An internal error occurred-the network
�
� � � cannot access a shared memory segment. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� NERR_WkstaNotStarted � 2138 � The Requester
service has not been �
� � � started. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� NERR_NoSuchAlert � 2432 � An incorrect or nonexistent alert name
�
� � � was raised. �
읕컴컴컴컴컴컴컴컴컴컴컴컴컴컴좔컴컴컴좔컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴켸
Other codes could be returned from the following functions:
For information about: