StopService-Methode der Win32_Service-Klasse (Sdoias.h) für den Terminaldienst
Die StopService WMI-Klassenmethode versetzt den durch das Win32 _ TerminalService-Objekt dargestellten Dienst in den Zustand "Beendet".
In diesem Thema wird die MOF-Syntax (Managed Object Format) verwendet. Weitere Informationen zur Verwendung dieser Methode finden Sie unter Aufrufen einer Methode.
Syntax
uint32 StopService();
Parameter
Diese Methode hat keine Parameter.
Rückgabewert
Gibt einen der in der folgenden Liste aufgeführten Werte oder einen anderen Wert zurück, um einen Fehler anzugeben. Weitere Fehlercodes finden Sie unter WMI-Fehlerkonstanten oder WbemErrorEnum. Allgemeine HRESULT-Werte finden Sie unter Systemfehlercodes.
-
0
-
Die Anforderung wurde akzeptiert.
-
1
-
Die Anforderung wird nicht unterstützt.
-
2
-
Der Benutzer hatte nicht den erforderlichen Zugriff.
-
3
-
Der Dienst kann nicht beendet werden, da andere ausgeführte Dienste davon abhängig sind.
-
4
-
Der angeforderte Steuerungscode ist nicht gültig, oder es ist für den Dienst nicht akzeptabel.
-
5
-
Der angeforderte Steuerungscode kann nicht an den Dienst gesendet werden, da der Zustand des Diensts (Win32 _ BaseService) ist.State-Eigenschaft) ist gleich 0, 1 oder 2.
-
6
-
Der Dienst wurde nicht gestartet.
-
7
-
Der Dienst hat auf die Startanforderung nicht rechtzeitig reagiert.
-
8
-
Unbekannter Fehler beim Starten des Diensts.
-
9
-
Der Verzeichnispfad zur ausführbaren Datei des Diensts wurde nicht gefunden.
-
10
-
Der Dienst wird schon ausgeführt.
-
11
-
Die Datenbank zum Hinzufügen eines neuen Diensts ist gesperrt.
-
12
-
Eine Abhängigkeit, von der dieser Dienst abhängt, wurde aus dem System entfernt.
-
13
-
Der Dienst hat den Dienst nicht gefunden, der von einem abhängigen Dienst benötigt wird.
-
14
-
Der Dienst wurde vom System deaktiviert.
-
15
-
Der Dienst hat nicht die richtige Authentifizierung, um im System ausgeführt zu werden.
-
16
-
Dieser Dienst wird aus dem System entfernt.
-
17
-
Der Dienst verfügt über keinen Ausführungsthread.
-
18
-
Der Dienst weist beim Start zirkuläre Abhängigkeiten auf.
-
19
-
Ein Dienst wird unter demselben Namen ausgeführt.
-
20
-
Der Dienstname weist ungültige Zeichen auf.
-
21
-
An den Dienst wurden ungültige Parameter übergeben.
-
22
-
Das Konto, unter dem dieser Dienst ausgeführt wird, ist entweder ungültig oder verfügt nicht über die Berechtigungen zum Ausführen des Diensts.
-
23
-
Der Dienst ist in der Datenbank der im System verfügbaren Dienste vorhanden.
-
24
-
Der Dienst ist im System derzeitig angehalten.
Hinweise
Nachdem Sie ermittelt haben, welche Dienste beendet oder angehalten werden können, können Sie die Dienste mithilfe der Methoden StopService und PauseService beenden und anhalten. Die Entscheidung, einen Dienst anzuhalten, anstatt ihn anzuhalten oder umgekehrt, hängt von mehreren Faktoren ab, einschließlich der folgenden:
- Kann der Dienst angehalten werden? Wenn dies nicht dere ist, ist die einzige Option das Beenden des Diensts.
- Müssen Sie weiterhin Clientanforderungen für personen verarbeiten, die bereits mit dem Dienst verbunden sind? In diesem Falle ermöglicht das Anhalten eines Diensts in der Regel die Verarbeitung vorhandener Clients, während der Zugriff auf neue Clients verweigert wird. Wenn Sie dagegen einen Dienst beenden, werden alle Clients sofort getrennt.
- Müssen Sie einen Dienst neu konfigurieren, damit die Änderungen sofort wirksam werden? Obwohl Diensteigenschaften geändert werden können, während ein Dienst angehalten wird, werden die meisten erst wirksam, wenn der Dienst tatsächlich beendet und neu gestartet wurde.
Der Skriptcode, der zum Beenden eines Diensts erforderlich ist, ist fast identisch mit dem Code, der zum Anhalten des Diensts erforderlich ist.
Wenn Sie versuchen, einen Dienst zu beenden, auf dem abhängige Dienste ausgeführt werden, schlägt die StopService-Methode mit dem Rückgabewert 3 fehl. Die abhängigen Dienste müssen zuerst beendet werden.
Wenn Sie einen Dienst beenden, überprüfen Sie sofort win32 _ TerminalService.State-Eigenschaft, da der -Wert den Dienst möglicherweise weiterhin als ausgeführt zeigt.
Beispiele
Set-RemoteService PowerShell-Beispiel Legt den Dienststatus für Remotecomputer fest.
Das Beispiel Stop a Service and Its Dependents VBScript beendet einen Dienst und alle abhängigen Dienste.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Namespace |
Root \ CIMv2 \ TerminalServices |
| Header |
|
| MOF |
|
| DLL |
|