NetAlertRaise

NetAlertRaise 関数は、特定のイベントが発生した際に登録済みのすべてのクライアントに通知する。

NetAlertRaise AlertType, Buffer, BufferSize

AlertType : [wstr] 発生させるアラートクラス (アラートの種類) を指定する定数文字列へのポインタ。このパラメータには、次の定義済みの値のいずれか、またはネットワークアプリケーション用にユーザー定義したアラートクラスを指定できる。アラートのイベント名には任意のテキスト文字列を指定できる。
Buffer : [intptr] 中断メッセージをリッスンしているクライアントに送信するデータへのポインタ。データは固定長の STD_ALERT 構造体で始まり、その後に ADMIN_OTHER_INFO、ERRLOG_OTHER_INFO、PRINT_OTHER_INFO、USER_OTHER_INFO のいずれか 1 つの構造体で追加のメッセージデータが続く。最後に、必要な可変長情報を含める。詳細は後述の解説セクションのコード例を参照。
BufferSize : [int] メッセージバッファのサイズ (バイト単位)。

(プラグイン / モジュール : netapi32.dll)

解説

NetAlertRaise 関数は、特定のイベントが発生した際に登録済みのすべてのクライアントに通知する。

[戻り値]
関数が成功した場合、戻り値は NERR_Success
となる。失敗した場合、戻り値はシステムエラーコードで、次のいずれかのエラーコードになる可能性がある。すべてのエラーコードの一覧は
System Error Codes を参照。
（以下省略）

[備考]
NetAlertRaise 関数を正常に実行するために特別なグループメンバーシップは必要ない。NetAlertRaise
関数を呼び出すときは、クライアントコンピューターで alerter サービスが実行されている必要があり、そうでない場合は関数は
ERROR_FILE_NOT_FOUND で失敗する。

情報