警示函式

[自 Windows Vista 起不支援警示函式，因為不支援警示程式和 Messenger 服務。

網路管理警示功能會通知網路服務程式和網路事件的應用程式。 事件是應用程式所定義之硬體之進程、發生次數或狀態的特定實例。 警示函式可讓應用程式指出何時發生預先定義的事件。

Windows Server 2003： 警示程式和 Messenger 服務預設會在 Windows Server 2003 上停用。 您必須先重新啟用服務，才能呼叫網路管理警示函式或網路管理 訊息函式。

警示函式如下所列。

函式	描述
NetAlertRaise	通知所有已註冊的用戶端發生特定事件。
NetAlertRaiseEx	簡化通知已註冊的用戶端，因為與 NetAlertRaise 不同，NetAlertRaiseEx不需要STD_ALERT結構。

 

當您呼叫NetAlertRaise 函式或 NetAlertRaiseEx函式時，警示程式服務必須在用戶端電腦上執行。 如果服務未執行，函式會失敗並 ERROR_FILE_NOT_FOUND。 用戶端上的警示服務會呼叫 NetMessageBufferSend 函式，以將資訊傳送給收件者。

應用程式、網路服務和內部網路元件會使用網路管理警示功能來引發警示，並在發生特定類型的事件時通知各種應用程式或使用者。 警示類別函數、資料類型、結構和常數定義于 LMCONS 中。H、LMERR。H 和 LMALERT。H 標頭檔。 若要存取這些定義，請定義常數INCL_NETERRORS和INCL_NETALERT，並包含標頭檔 LM.H。

LMALERT。H 檔案預先定義下列警示類別， (傳送警示) 類型的網路事件：

• 需要系統管理協助的網路事件
• 將專案新增至錯誤記錄檔
• 使用者或應用程式接收廣播訊息
• 列印工作完成
• 使用者使用特定應用程式或資源

您可以視需要定義網路應用程式的其他警示類別。 例如，如果伺服器上的應用程式會定期將大量資料寫入磁片磁碟機，應用程式就會執行填滿磁片的風險。 在此情況下，您可能會想要新增「沒有可用磁碟空間」事件來觸發警示，通知應用程式暫停或終止填滿磁片的程式。 警示的事件名稱可以是任何文字字串。

當您使用對 NetAlertRaise 函式的呼叫引發警示時，訊息資料應該包含一個 STD_ALERT 標頭結構，後面接著一個 ADMIN_OTHER_INFO、 ERRLOG_OTHER_INFO、 PRINT_OTHER_INFO或 USER_OTHER_INFO 結構中特定的其他固定長度資料。 額外的可變長度資料可以遵循警示特定的結構。 (對 NetAlertRaiseEx 函式的呼叫不需要 STD_ALERT structure.) 呼叫應用程式必須配置所有結構和可變長度資料的記憶體，並在呼叫傳回之後釋放記憶體。

下列宏可用於警示資料緩衝區。

巨集	描述
ALERT_OTHER_INFO	傳回警示訊息中 STD_ALERT 結構的固定長度資料的指標。
ALERT_VAR_DATA	傳回變數長度資料的指標，該資料會遵循警示訊息中的警示特定資料。

 

您可以使用 Windows Management Instrumentation (WMI) SDK 來通知事件，而不是使用網路管理警示功能。 如需支援 WMI 事件模型之平臺的詳細資訊，請參閱 WMI 檔中的 WMI 基礎結構 和 監視事件 。