Udostępnij przez

Funkcje alertów

[Funkcje alertów nie są obsługiwane w systemie Windows Vista, ponieważ usługi alertów i komunikatora nie są obsługiwane.]

Funkcje alertów zarządzania siecią powiadamiają programy usług sieciowych i aplikacje zdarzeń sieciowych. Zdarzenie jest konkretnym wystąpieniem procesu, wystąpienia lub stanu sprzętu zdefiniowanego przez aplikację. Funkcje alertów umożliwiają aplikacjom wskazanie, kiedy wystąpią wstępnie zdefiniowane zdarzenia.

Windows Server 2003: Usługi alertów i komunikatora są domyślnie wyłączone w systemie Windows Server 2003. Należy ponownie włączyć usługi przed wywołaniem funkcji alertu zarządzania siecią lub funkcji zarządzania siecią funkcje komunikatów.

Poniżej wymieniono funkcje alertów.

Funkcja Opis
NetAlertRaise Powiadamia wszystkich zarejestrowanych klientów o wystąpieniu określonego zdarzenia.
NetAlertRaiseEx Upraszcza powiadamianie zarejestrowanych klientów o wystąpieniu określonego zdarzenia, ponieważ w przeciwieństwie do NetAlertRaise, NetAlertRaiseEx nie wymaga struktury STD_ALERT.

 

Usługa alertu musi być uruchomiona na komputerze klienckim po wywołaniu funkcji NetAlertRaise lub funkcji NetAlertRaiseEx. Jeśli usługa nie jest uruchomiona, funkcje kończą się niepowodzeniem z ERROR_FILE_NOT_FOUND. Usługa alertera na kliencie wywołuje funkcję NetMessageBufferSend w celu wysyłania informacji do adresatów.

Aplikacje, usługi sieciowe i składniki sieci wewnętrznej używają funkcji alertów zarządzania siecią do zgłaszania alertów, powiadamiania różnych aplikacji lub użytkowników o wystąpieniu określonego typu zdarzenia. Funkcje kategorii alertów, typy danych, struktury i stałe są definiowane w usłudze LMCONS. H, LMERR. H, i LMALERT. Pliki nagłówków H. Aby uzyskać dostęp do tych definicji, zdefiniuj stałe INCL_NETERRORS i INCL_NETALERT oraz dołącz plik nagłówka LM.H.

The LMALERT. Plik H wstępnie zdefiniowane następujące klasy alertów (typy zdarzeń sieciowych) do wysyłania alertów:

  • Zdarzenia sieciowe wymagające pomocy administracyjnej
  • Dodawanie wpisu do pliku dziennika błędów
  • Odbiór komunikatu emisji przez użytkownika lub aplikację
  • Ukończenie zadania drukowania
  • Korzystanie z niektórych aplikacji lub zasobów przez użytkowników

W razie potrzeby można zdefiniować inne klasy alertów dla aplikacji sieciowych. Jeśli na przykład aplikacja na serwerze rutynowo zapisuje duże ilości danych na dysku, aplikacja ryzykuje wypełnienie dysku. W takim przypadku możesz dodać zdarzenie "brak wolnego miejsca na dysku", aby wyzwolić alert, który powiadamia aplikację o wstrzymaniu lub zakończeniu procesu wypełniania dysku. Nazwa zdarzenia alertu może być dowolnym ciągiem tekstowym.

W przypadku zgłaszania alertu z wywołaniem funkcji NetAlertRaise dane komunikatu powinny składać się z jednej struktury nagłówka STD_ALERT, a następnie dodatkowych danych o stałej długości specyficznej dla jednego ADMIN_OTHER_INFO, ERRLOG_OTHER_INFO, PRINT_OTHER_INFO, lub struktura USER_OTHER_INFO. Dodatkowe dane o zmiennej długości mogą być zgodne ze strukturą specyficzną dla alertów. (Wywołania funkcji NetAlertRaiseEx nie wymagają struktury STD_ALERT). Aplikacja wywołująca musi przydzielić pamięć dla wszystkich struktur i danych o zmiennej długości oraz zwolnić pamięć po powrocie wywołania.

Następujące makra są dostępne do użycia z danych alertów.

Makro Opis
ALERT_OTHER_INFO Zwraca wskaźnik do danych o stałej długości, które są zgodne ze strukturą STD_ALERT w komunikacie alertu.
ALERT_VAR_DATA Zwraca wskaźnik do danych o zmiennej długości, które są zgodne z danymi specyficznymi dla alertu w komunikacie alertu.

 

Zamiast korzystać z funkcji alertów zarządzania siecią, możesz użyć zestawu SDK instrumentacji zarządzania Windows (WMI) do powiadamiania o zdarzeniach. Aby uzyskać więcej informacji na temat platform obsługujących model zdarzeń usługi WMI, zobacz infrastruktura WMI i zdarzenia monitorowania w dokumentacji usługi WMI.

 

 

  • Last updated on