Create-Methode der Win32_BaseService-Klasse

Artikel
06/12/2023

Die CreateWMI-Klassenmethode erstellt einen neuen Dienst. Der Parameter LoadOrderGroup stellt eine Gruppierung von Systemdiensten dar, die Ausführungsabhängigkeiten definieren. Die Dienste müssen in der von der Load Order Group angegebenen Reihenfolge initiiert werden, da die Dienste voneinander abhängig sind. Diese abhängigen Dienste erfordern das Vorhandensein der vorgängern Dienste, damit sie ordnungsgemäß funktionieren.

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

Syntax

uint32 Create(
  [in] string  Name,
  [in] string  DisplayName,
  [in] string  PathName,
  [in] uint8   ServiceType,
  [in] uint8   ErrorControl,
  [in] string  StartMode,
  [in] boolean DesktopInteract,
  [in] string  StartName,
  [in] string  StartPassword,
  [in] string  LoadOrderGroup,
  [in] string  LoadOrderGroupDependencies[],
  [in] string  ServiceDependencies[]
);

Parameter

Name [in]

Name des Diensts, der in der Create-Methode installiert werden soll. Die maximale Zeichenfolgenlänge beträgt 256 Zeichen. Die Datenbank des Dienststeuerungs-Managers behält die Groß-/Kleinschreibung der Zeichen bei, bei Dienstnamenvergleichen wird jedoch immer zwischen Groß-/Kleinschreibung unterschieden. Schrägstriche (/) und doppelte Schrägstriche (\) sind ungültige Dienstnamenzeichen.

DisplayName [in]

Anzeigename des Diensts. Die maximale Länge der Zeichenfolge beträgt 256 Zeichen. Der Name wird im Dienststeuerungs-Manager in Groß-/Kleinschreibung beibehalten. Bei DisplayName-Vergleichen wird immer zwischen Groß-/Kleinschreibung unterschieden.

Einschränkungen: Akzeptiert denselben Wert wie der Name-Parameter .

Beispiel: "Atdisk".

PathName [in]

Vollqualifizierter Pfad zu der ausführbaren Datei, die den Dienst implementiert.

Beispiel: "\SystemRoot\System32\drivers\afd.sys".

ServiceType [in]

Art der Dienste, die für Prozesse bereitgestellt werden, die sie aufrufen. Der Wert ist eine Bitmap.

Kerneltreiber (1)

Dateisystemtreiber (2)

Adapter (4)

Erkennungstreiber (8)

Eigener Prozess (16)

Freigabeprozess (32)

256

Interaktiver Prozess

ErrorControl [in]

Schweregrad des Fehlers, wenn die Create-Methode nicht gestartet werden kann. Der Wert gibt die Aktion an, die vom Startprogramm ausgeführt wird, wenn ein Fehler auftritt. Alle Fehler werden vom System protokolliert.

Ignorieren (0)

Der Benutzer wird nicht benachrichtigt.

Normal (1)

Der Benutzer wird benachrichtigt.

Schwerwiegend (2)

Das System wird mit der letzten bekannten, fehlerfreien Konfiguration neu gestartet.

Kritisch (3)

Das System versucht, mit einer guten Konfiguration zu beginnen.

StartMode [in]

Startmodus des Windows-Basisdiensts.

Startstart ("Start")

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

Systemstart ("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.

DesktopInteract [in]

Wenn true, kann der Dienst Fenster auf dem Desktop erstellen oder mit ihnen kommunizieren.

StartName [in]

Kontoname, unter dem der Dienst ausgeführt wird. Je nach Diensttyp kann der Kontoname in der Form "Domänenname\Benutzername" vorliegen. Der Dienstprozess wird bei der Ausführung mit einem dieser beiden Formulare protokolliert. Wenn das Konto zur integrierten Domäne gehört, kann ".\Username" angegeben werden. Wenn NULL angegeben ist, wird der Dienst als LocalSystem-Konto angemeldet. Bei Treibern auf Kernel- oder Systemebene enthält StartName den Treiberobjektnamen (d. h. \FileSystem\Rdr oder \Driver\Xns), den das Eingabe- und Ausgabesystem (E/A) zum Laden des Gerätetreibers verwendet. Wenn NULL angegeben ist, wird der Treiber mit einem Standardobjektnamen ausgeführt, der vom E/A-System basierend auf dem Dienstnamen erstellt wird. Beispiel: DWDOM\Admin.

StartPassword [in]

Kennwort für den Kontonamen, der durch den Parameter StartName angegeben wird. Geben Sie NULL an, wenn Sie das Kennwort nicht ändern. Geben Sie eine leere Zeichenfolge an, wenn der Dienst kein Kennwort besitzt.

LoadOrderGroup [in]

Der dem neuen Dienst zugeordnete Gruppenname. Ladereihenfolgegruppen sind in der Registrierung enthalten und bestimmen die Reihenfolge, in der Dienste in das Betriebssystem geladen werden. Wenn der Zeiger NULL ist oder auf eine leere Zeichenfolge zeigt, gehört der Dienst nicht zu einer Gruppe. Abhängigkeiten zwischen Gruppen sollten im Parameter LoadOrderGroupDependencies aufgeführt werden. Dienste in der Liste der Lastenreihenfolgen werden zuerst gestartet, gefolgt von Diensten in Gruppen, die nicht in der Liste der Lastenreihenfolgengruppe enthalten sind, gefolgt von Diensten, die nicht zu einer Gruppe gehören. Die Registrierung enthält eine Liste der Ladereihenfolgegruppen unter:

HKEY_LOCAL_MACHINE\System\Currentcontrolset\Steuerung\ServiceGroupOrder

LoadOrderGroupDependencies [in]

Array von Lastenreihenfolgegruppen, die vor diesem Dienst gestartet werden müssen. Jedes Element im Array wird durch NULL getrennt, und die Liste wird durch zwei NULL-Werte beendet. In Visual Basic oder skript können Sie vbArray übergeben. Wenn der Zeiger NULL ist oder auf eine leere Zeichenfolge zeigt, weist der Dienst keine Abhängigkeiten auf. Gruppennamen müssen mit dem SC_GROUP_IDENTIFIER (in der Datei Winsvc.h definiert) vorangestellt werden, um ihn von einem Dienstnamen zu unterscheiden, da Dienste und Dienstgruppen denselben Namespace verwenden. „Abhängigkeit von einer Gruppe“ bedeutet, dass dieser Dienst ausgeführt werden kann, wenn nach einem Versuch, alle Mitglieder der Gruppe zu starten, mindestens ein Mitglied der Gruppe ausgeführt wird.

Dienstabhängigkeiten [in]

Array, das Namen von Diensten enthält, die gestartet werden müssen, bevor dieser Dienst gestartet wird. Jedes Element im Array wird durch NULL getrennt, und die Liste wird durch zwei NULL-Werte beendet. In Visual Basic oder skript können Sie vbArray übergeben. Wenn der Zeiger NULL ist oder auf eine leere Zeichenfolge zeigt, weist der Dienst keine Abhängigkeiten auf. Abhängigkeit von einem Dienst bedeutet, dass dieser Dienst nur ausgeführt werden kann, wenn der Dienst ausgeführt wird, von dem er abhängt.

Rückgabewert

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

Erfolgreich

Die Anforderung wurde akzeptiert.

Nicht unterstützt

Die Anforderung wird nicht unterstützt.

Zugriff verweigert

Der Benutzer hatte nicht den erforderlichen Zugriff.

Abhängige Dienste, die ausgeführt werden

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

Ungültiges Dienststeuerelement

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

Der Dienst kann die Steuerung nicht akzeptieren.

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

Der Dienst wurde nicht gestartet.

Dienstanforderungstimeout

Der Dienst hat auf die Startanforderung nicht rechtzeitig reagiert.

Unbekannter Fehler

Interaktiver Prozess.

Pfad nicht gefunden

Der Verzeichnispfad zur ausführbaren Dienstdatei wurde nicht gefunden.

Dienst wird bereits ausgeführt

Der Dienst wird schon ausgeführt.

Dienstdatenbank gesperrt

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

Dienstabhängigkeit gelöscht

Eine Abhängigkeit, von der dieser Dienst abhängt, wurde aus dem System entfernt.

Dienstabhängigkeitsfehler

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

Dienst deaktiviert

Der Dienst wurde vom System deaktiviert.

Fehler bei der Dienstanmeldung

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

Dienst, der zum Löschen markiert ist

Dieser Dienst wird aus dem System entfernt.

Dienst ohne Thread

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

Statuskreisabhängigkeit

Es gibt Ringabhängigkeiten beim Starten des Diensts.

Doppelter Name des Status

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

Status Ungültiger Name

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

Status Ungültiger Parameter

Ungültige Parameter wurden an den Dienst übergeben.

Status Ungültiges Dienstkonto

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.

Statusdienst vorhanden

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

Dienst bereits angehalten

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