UserControlService-Methode der Win32_BaseService-Klasse

Die WMI-Klassenmethode versucht, einen benutzerdefinierten Steuerelementcode an einen Dienst zu senden.

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

Syntax

uint32 UserControlService(
  [in] uint8 ControlCode
);

Parameter

ControlCode [in]

Wert, der einen Steuerelementbefehl für einen Dienst angibt. Ein Steuerungsbefehl ist beispielsweise ein "Anhalten" oder "Weiter"-Befehl. Der Wert kann ein vordefinierter Code oder ein Wert und eine Aktion sein, die der Dienst definiert. Im Folgenden sind die vordefinierten Steuercodes aufgeführt:

SERVICE_CONTROL_CONTINUE

Benachrichtigt einen angehaltenen Dienst zur Fortsetzung.

SERVICE_CONTROL_INTERROGATE

Benachrichtigt einen Dienst, um die aktuellen status Informationen an den Dienststeuerungs-Manager zu melden.

SERVICE_CONTROL_NETBINDADD

Benachrichtigt einen Netzwerkdienst, dass eine neue Komponente für die Bindung vorhanden ist.

SERVICE_CONTROL_NETBINDDISABLE

Benachrichtigt einen Netzwerkdienst, dass eine seiner Bindungen deaktiviert ist.

SERVICE_CONTROL_NETBINDENABLE

Benachrichtigt einen Netzwerkdienst, dass eine deaktivierte Bindung aktiviert ist.

SERVICE_CONTROL_NETBINDREMOVE

Benachrichtigt einen Netzwerkdienst, dass eine Komponente für die Bindung entfernt wurde.

SERVICE_CONTROL_PARAMCHANGE

Benachrichtigt einen Dienst, dass seine Startparameter geändert werden.

SERVICE_CONTROL_PAUSE

Benachrichtigt einen Dienst, anzuhalten.

SERVICE_CONTROL_STOP

Benachrichtigt einen Dienst zum Beenden.

Rückgabewert

Gibt einen der in der folgenden Liste aufgeführten Werte oder einen anderen Wert zurück, um einen Fehler anzugeben.

Erfolgreich

0

Die Anforderung wird akzeptiert.

Nicht unterstützt

1

Die Anforderung wird nicht unterstützt.

Zugriff verweigert

2

Der Benutzer verfügt nicht über die erforderlichen Zugriffsrechte.

Abhängige Dienste, die ausgeführt werden

3

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

Ungültige Dienststeuerung

4

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

Der Dienst kann keine Steuerung 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 reagiert nicht schnell auf die Startanforderung.

Unbekannter Fehler

8

Interaktiver Prozess.

Pfad nicht gefunden

9

Der Verzeichnispfad zur ausführbaren Datei des Diensts wurde nicht gefunden.

Dienst, der bereits ausgeführt wird

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, wird aus dem System entfernt.

Dienstabhängigkeitsfehler

13

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

Dienst deaktiviert

14

Der Dienst ist 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

Der Dienst wird aus dem System entfernt.

Kein Thread für Dienst

17

Es gibt keinen Ausführungsthread für den Dienst.

Statuskreisabhängigkeit

18

Es gibt Ringabhängigkeiten beim Starten des Diensts.

Status duplizierter Name

19

Es wird ein Dienst unter dem gleichen Namen ausgeführt.

Status Ungültiger Name

20

Der Name des Diensts enthält ungültige Zeichen.

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 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

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_BaseService