ChangeStartMode-Methode der Win32_Service-Klasse (CIMWin32 WMI-Anbieter)

Die WMI-KlassenmethodeChangeStartMode ändert den Startmodus eines Win32_Service.

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

Syntax

uint32 ChangeStartMode(
  [in] string StartMode = Auto Start
);

Parameter

StartMode [in]

Startmodus des Windows-Basisdiensts.

Startstart ("Start")

Gerätetreiber, der vom Betriebssystemladeprogramm gestartet wird. Dieses Wert ist nur für Treiberdienste gültig.

System ("System")

Gerätetreiber, der vom Initialisierungsprozess des Betriebssystems gestartet wird. Dieses Wert ist nur für Treiberdienste gültig.

Automatischer Start ("Automatisch")

Der Dienst soll während des Systemstarts automatisch vom Dienstkontroll-Manager gestartet werden.

Bedarfsstart ("Manuell")

Dienst, der vom Dienststeuerungs-Manager gestartet werden soll, wenn ein Prozess die StartService-Methode aufruft.

Deaktiviert ("Deaktiviert")

Dienst, der nicht mehr gestartet werden kann.

Rückgabewert

Gibt einen der in der folgenden Liste aufgeführten Werte oder einen anderen Wert zurück, der auf einen Fehler hinweist. Weitere Fehlercodes finden Sie unter WMI-Fehlerkonstanten oder WbemErrorEnum. Allgemeine HRESULT-Werte finden Sie unter Systemfehlercodes.

Erfolgreich

0

Die Anforderung wurde akzeptiert.

Nicht unterstützt

1

Die Anforderung wird nicht unterstützt.

Zugriff verweigert

2

Der Benutzer hatte nicht den erforderlichen Zugriff.

Abhängige Dienste, die ausgeführt werden

3

Der Dienst kann nicht beendet werden, da andere ausgeführte Dienste davon abhängig sind.

Ungültiges Dienststeuerelement

4

Der angeforderte Steuerungscode ist nicht gültig, oder es ist für den Dienst nicht akzeptabel.

Der Dienst kann die Steuerung nicht akzeptieren.

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.

Dienst nicht aktiv

6

Der Dienst wurde nicht gestartet.

Dienstanforderungstimeout

7

Der Dienst hat auf die Startanforderung nicht rechtzeitig reagiert.

Unbekannter Fehler

8

Unbekannter Fehler beim Starten des Diensts.

Pfad nicht gefunden

9

Der Verzeichnispfad zur ausführbaren Dienstdatei wurde nicht gefunden.

Dienst wird bereits ausgeführt

10

Der Dienst wird schon ausgeführt.

Dienstdatenbank gesperrt

11

Die Datenbank zum Hinzufügen eines neuen Diensts ist gesperrt.

Dienstabhängigkeit gelöscht

12

Eine Abhängigkeit, auf der sich dieser Dienst stützt, wurde aus dem System entfernt.

Dienstabhängigkeitsfehler

13

Der Dienst hat den Dienst nicht gefunden, der von einem abhängigen Dienst benötigt wird.

Dienst deaktiviert

14

Der Dienst wurde vom System deaktiviert.

Fehler bei der Dienstanmeldung

15

Der Dienst hat nicht die richtige Authentifizierung, um im System ausgeführt zu werden.

Dienst, der zum Löschen markiert ist

16

Dieser Dienst wird aus dem System entfernt.

Dienst ohne Thread

17

Der Dienst verfügt über keinen Ausführungsthread.

Statuskreisabhängigkeit

18

Der Dienst verfügt beim Start über zirkuläre Abhängigkeiten.

Doppelter Name des Status

19

Ein Dienst wird unter demselben Namen ausgeführt.

Status Ungültiger Name

20

Der Dienstname weist ungültige Zeichen auf.

Status Ungültiger Parameter

21

Ungültige Parameter wurden an den Dienst übergeben.

Status Ungültiges Dienstkonto

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.

Statusdienst vorhanden

23

Der Dienst ist in der Datenbank der im System verfügbaren Dienste vorhanden.

Dienst bereits angehalten

24

Der Dienst ist im System derzeitig angehalten.

Andere

25 4294967295

Beispiele

Das folgende Change StartMode of a Service PowerShell-Beispiel, das aus dem TechNet-Katalog abgerufen wird, ändert den Startmodus eines Diensts.

$wmi = get-wmiobject -class win32_service -namespace root\cimv2 -computername lisbon | 
where-object { $_.name -eq 'bits' } 
 
$rtn = $wmi.changestartmode("manual") 
if($rtn.returnvalue -eq 0) { "success" } 
ELSE 
  { " $($rtn.returnvalue) was reported" }

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_Service

WMI-Aufgaben: Dienste