NtSvc Komponente für Windows NT, Windows 2000

NtSvcCom (Win NT Service-Komponente) listet, startet und stoppt installierte Windows NT Dienstprogramme (Service).

Mit dieser Komponente kann überprüft werden, in welchem Zustand sich ein Service befindet.

Beispiel (ASP-CODE/VB-Script)

<%
Set oNTService = Server.CreateObject("ISSB.NtSvc")
if oNTService.IsInstalled("DNSServer") then
  Response.Write "DNS-Server ist installiert"
  if oNTService.IsRunning("DNSServer") then
    Response.Write "und läuft..."
  else
    Response.Write "ABER steht!"
  end if
else
  Response.Write "DNS-Server ist nicht installiert!"
end if
Set oNTService = Nothing
%>

Installation

• Komponente laden... (Bitte nur laden und installieren, wenn Sie die Nutzungsbedingungen gelesen haben.)
• Komponente auspacken und die Datei NtSvcCom.dll in ein beliebiges Verzeichnis der lokalen Festplatte kopieren...
• Registrieren: regsvr32 [komponenten-dir]\NtSvcCom.dll ausführen...
  komponenten-dir ist das Verzeichnis, in der sich die DLL befindet.

Deinstallation

Um die Komponente zu deinstallieren, muss der Webserver-Administrationsdienst (IISADMIN) beendet werden. Der Webserver kann im Windows NT-Dienste-Manager beendet werden. Ein "Anhalten"-Klick im Webserver-Manager (MS MMC) alleine reicht nicht aus.

Die Komponente wird dann mit regsvr32 [komponenten-dir]\NtSvcCom.dll /u aus der System-Registrierung entfernt und kann dann einfach aus dem Verzeichnis gelöscht werden.

Methoden

• DeleteService(string ServiceName)
  Löscht den angegebenen Service aus dem SCM (Service Control Manager).
  ServiceName ist der Kurzname des Dienstprogrammes.
   
• string GetNextDependentServiceName(bool First)
  Gibt bei First = True den ersten abhängigen, bei First = False den nächsten Dienstprogrammnamen der ermittelten Liste zurück.
  Setzt den Funktionsaufruf SnapDependentServices voraus.
   
• string GetNextServiceName(bool First)
  Gibt bei First = True den ersten, bei First = False den nächsten Dienstprogrammnamen der ermittelten Liste zurück.
  Setzt den Funktionsaufruf SnapServices voraus.
   
• long GetServiceCurrentState(string ServiceName)
  gibt den aktuellen Status des angegebenen Dienstprogrammes zurück.
  Rückgabewert:
  1: Service gestoppt
  2: Service wird gestartet
  3: Service wird gestoppt
  4: Service gestartet
  5: Service wird erneut gestartet
  6: Service pausiert
   
• bool IsInstalled(string ServiceName)
  gibt True zurück, wenn der angegebene Service installiert ist, ansonsten False.
   
• bool IsRunning(string ServiceName)
  gibt True zurück, wenn der angegebene Service gestartet ist, ansonsten False.
   
• long SnapDependentServices(string ServiceName, long State)
  Ermittelt alle von ServiceName abhängigen Dienstprogramme in Abhängigkeit von State und fasst sie in einer internen Liste zusammen. Die Liste kann mit der Methode GetNextDependentServiceName abgefragt werden.
  State = 1: es werden alle aktiven Dienstprogramme ermittelt
  State = 2: es werden alle deaktivierten Dienstprogramme ermittelt
  State = 3: es werden alle installierten Dienstprogramme ermittelt
  Es wird die Anzahl ermittelter Dienstprogramme zurückgegeben.
   
• long SnapServices(long State)
  Ermittelt alle installierten Dienstprogramme in Abhängigkeit von State und fasst sie in einer internen Liste zusammen.
  Die Liste kann mit der Methode GetNextServiceName abgefragt werden.
  State = 1: es werden alle aktiven Dienstprogramme ermittelt
  State = 2: es werden alle deaktivierten Dienstprogramme ermittelt
  State = 3: es werden alle installierten Dienstprogramme ermittelt
  Es wird die Anzahl ermittelter Dienstprogramme zurückgegeben.
   
• Start(string ServiceName)
  Startet den angegebenen Dienst.
   
• Stop(string ServiceName)
  Stoppt den angegebenen Dienst.
   

Alle Methoden lösen bei aufgetretenen Fehlern eine Ausnahme aus, die mit On Error ... abgefangen werden kann. Die Fehlerbeschreibung ist im Error-Objekt enthalten

Eigenschaften

• long CurrentState
  Gibt an, in welchem Zustand sich das aktuelle Dienstprogramm befindet.
  Das aktuelle Dienstprogramm wird durch die Ausführung der Methoden SnapServices und GetNextServiceName gesetzt.
  Eigenschaft kann nur gelesen werden.
   
• string DisplayName
  Gibt den angezeigten Namen des aktuellen Dienstprogramms zurück.
  Das aktuelle Dienstprogramm wird durch die Ausführung der Methoden SnapServices und GetNextServiceName gesetzt.
  Eigenschaft kann nur gelesen werden.
   
• string MachineName string
  Setzt und gibt den Computernamen an, auf dem Dienstprogramme ermittelt werden.
   

[NtSvcCom herunterladen]

© 2002 ISSB. Alle Rechte vorbehalten.