PauseService-Methode der Win32_SystemDriver-Klasse

Artikel
06/12/2023

Die WMI-KlassenmethodePauseService versucht, den vom logischen Systemtreiber verwalteten Dienst in den angehaltenen Zustand zu versetzen.

In diesem Thema wird MOF-Syntax (Managed Object Format) verwendet. Weitere Informationen zur Verwendung dieser Methode finden Sie unter Aufrufen einer Methode.

Syntax

uint32 PauseService();

Parameter

Diese Methode hat keine Parameter.

Rückgabewert

Gibt den Wert 0 (null) zurück, wenn die PauseService-Anforderung akzeptiert wurde, 1 (1), wenn die Anforderung nicht unterstützt wird, und eine andere Zahl, die auf einen Fehler hinweist.

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 Status des Diensts (Win32_BaseService. 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: Beim Starten des Diensts ist ein unbekannter Fehler aufgetreten.
9: Der Verzeichnispfad zur ausführbaren Dienstdatei 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, auf der sich dieser Dienst stützt, 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: Es gibt keinen Ausführungsthread für den Dienst.
18: Es gibt Ringabhängigkeiten beim Starten des Diensts.
19: Es wird ein Dienst unter dem gleichen Namen ausgeführt.
20: Der Name des Diensts enthält ungültige Zeichen.
21: Ungültige Parameter wurden an den Dienst übergeben.
22: Das Konto, unter dem dieser Dienst ausgeführt werden soll, 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.

Beispiele

Der folgende PowerShell-Code versucht, den Dienst "Microsoft USB-Druckerklasse" anzuhalten.

$usbPrintDriver = Get-WmiObject -query "SELECT * FROM Win32_SystemDriver WHERE Name = 'usbprint'"
$Return = $usbPrintDriver.PauseService()
"Pause Service called. The return value is " + $return.ReturnValue + "."
"To figure out what this means, go look at the docs above this code snippet."

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	WindowsServer 2008
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Siehe auch

Betriebssystemklassen
Win32_SystemDriver