アラート関数

[アラート機能は Windows Vista ではサポートされていません。アラート サービスとメッセンジャー サービスはサポートされていません。

ネットワーク管理アラート機能は、ネットワーク サービス プログラムとネットワーク イベントのアプリケーションに通知します。 イベント は、アプリケーションによって定義されたハードウェアのプロセス、発生、または状態の特定のインスタンスです。 アラート関数を使用すると、事前に定義されたイベントがいつ発生するかをアプリケーションで示すことができるようになります。

Windows Server 2003: Windows Server 2003 では、アラート サービスとメッセンジャー サービスが既定で無効になっています。 ネットワーク管理アラート機能を呼び出す前に、サービスを再度有効にするか、メッセージ機能 ネットワーク管理をする必要があります。

アラート関数の一覧を次に示します。

NetAlertRaise 関数または NetAlertRaiseEx 関数を呼び出すときに、クライアント コンピューターでアラーラー サービスが実行されている必要があります。 サービスが実行されていない場合、関数は ERROR_FILE_NOT_FOUNDで失敗します。 クライアントのアラート サービスは、NetMessageBufferSend 関数を呼び出して、受信者に情報を送信します。

アプリケーション、ネットワーク サービス、および内部ネットワーク コンポーネントは、ネットワーク管理アラート機能を使用してアラートを生成し、特定の種類のイベントが発生したときにさまざまなアプリケーションまたはユーザーに通知します。 アラート カテゴリ関数、データ型、構造体、および定数は LMCONS で定義されます。H、LMERR。H、および LMALERT。H ヘッダー ファイル。 これらの定義にアクセスするには、INCL_NETERRORSおよびINCL_NETALERT定数を定義し、ヘッダー ファイル LM.H を含めます。

LMALERT。H ファイルでは、アラートを送信するための次のアラート クラス (ネットワーク イベントの種類) が事前に定義されています。

• 管理支援を必要とするネットワーク イベント
• エラー ログ ファイルへのエントリの追加
• ユーザーまたはアプリケーションによるブロードキャスト メッセージの受信
• 印刷ジョブの完了
• ユーザーによる特定のアプリケーションまたはリソースの使用

必要に応じて、ネットワーク アプリケーションのアラートの他のクラスを定義できます。 たとえば、サーバー上のアプリケーションが大量のデータをディスク ドライブに定期的に書き込む場合、アプリケーションはディスクがいっぱいになるリスクを実行します。 この場合は、イベント "空きディスク領域なし" を追加して、ディスクを満たすプロセスを一時停止または終了するようにアプリケーションに通知するアラートをトリガーできます。 アラートのイベント名には、任意のテキスト文字列を指定できます。

NetAlertRaise 関数を呼び出してアラートを発生させる場合、メッセージ データは 1 つの STD_ALERT ヘッダー構造で構成され、その後に 1 つの ADMIN_OTHER_INFOでアラート固有の追加の固定長データ (ERRLOG_OTHER_INFO、PRINT_OTHER_INFO、 または USER_OTHER_INFO 構造体。 追加の可変長データは、アラート固有の構造に従うことができます。 (NetAlertRaiseEx 関数の呼び出しには、STD_ALERT 構造体は必要ありません)。呼び出し元のアプリケーションは、すべての構造体と可変長データにメモリを割り当て、呼び出しが戻った後にメモリを解放する必要があります。

アラート データ バッファーで使用できるマクロは次のとおりです。

ネットワーク管理アラート機能を使用する代わりに、イベント通知に Windows Management Instrumentation (WMI) SDK を使用できる場合があります。 WMI イベント モデルをサポートするプラットフォームの詳細については、WMI ドキュメントの「WMI インフラストラクチャの と 監視イベント を する」を参照してください。