Create-Methode der Win32_Service-Klasse (Remotedesktopdienste)
Die Methode WMI-Klasse erstellen erstellt einen neuen Systemdienst.
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 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 Service Control Manager-Datenbank behält die Groß-/Kleinschreibung der Zeichen bei, bei Dienstnamenvergleichen wird jedoch immer die Groß-/Kleinschreibung beachtet. Schrägstriche (/) und doppelte umgekehrte 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 beibehalten. Bei DisplayName-Vergleichen wird die Groß-/Kleinschreibung immer nicht beachtet.
Einschränkungen: Akzeptiert den gleichen Wert wie der Name-Parameter.
Beispiel: "Atdisk".
-
PathName [ In]
-
Vollqualifizierte Pfad zur ausführbaren Datei, die den Dienst implementiert.
Beispiel: \ "SystemRoot \ \ System32-Treiber \afd.sys".
-
ServiceType [ In]
-
Typ der Dienste, die für Prozesse bereitgestellt werden, die sie aufrufen.
-
1 (0x1)
-
Kerneltreiber
-
2 (0x2)
-
Dateisystemtreiber
-
4 (0x4)
-
Adapter
-
8 (0x8)
-
Erkennungstreiber
-
16 (0x10)
-
Eigener Prozess
-
32 (0x20)
-
Freigabeprozess
-
256 (0x100)
-
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.
0
Der Benutzer wird nicht benachrichtigt.
1
Der Benutzer wird benachrichtigt.
2
Das System wird mit der letzten bekannten, fehlerfreien Konfiguration neu gestartet.
3
Das System versucht, mit einer guten Konfiguration zu beginnen.
StartMode [ In]
Startmodus des Windows Basisdiensts.
Start
Vom Betriebssystemladeprogramm gestarteter Gerätetreiber. Dieses Wert ist nur für Treiberdienste gültig.
System
Der Vom Initialisierungsprozess des Betriebssystems gestartete Gerätetreiber. Dieses Wert ist nur für Treiberdienste gültig.
Automatic
Der Dienst wird während des Systemstarts automatisch vom Dienststeuerungs-Manager gestartet.
Manuell
Dienst, der vom Dienststeuerungs-Manager gestartet werden soll, wenn ein Prozess die StartService-Methode aufruft.
Disabled
Dienst, der nicht mehr gestartet werden kann.
DesktopInteract [ In]
True gibt an, dass der Dienst Windows auf dem Desktop erstellen oder mit ihnen kommunizieren kann.
StartName [ In]
Kontoname, unter dem der Dienst ausgeführt wird. Je nach Diensttyp kann der Kontoname im Format DomainName \ Username oder User Principal Name (UPN) () Username@DomainName vorliegen. Der Dienstprozess wird bei der Ausführung in einer dieser beiden Formen protokolliert. Wenn das Konto zur integrierten Domäne gehört, . \ Der Benutzername kann angegeben werden. Wenn NULL angegeben wird, wird der Dienst als LocalSystem-Konto angemeldet. Für Treiber auf Kernel- oder Systemebene enthält StartName den Namen des Treiberobjekts (d.h. \ FileSystem \ Rdr oder \ Driver \ Xns), den das E/A-System 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 wurde. Beispiel: DWDOM \ Admin.
StartPassword [ In]
Kennwort für den vom StartName-Parameter angegebenen Kontonamen. Geben Sie NULL an, wenn Sie das Kennwort nicht ändern. Geben Sie eine leere Zeichenfolge an, wenn der Dienst kein Kennwort besitzt.
LoadOrderGroup [ In]
Gruppenname, der dem neuen Dienst zugeordnet ist. Ladereihenfolgengruppen 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 LoadOrderGroupDependencies-Parameter aufgeführt werden. Dienste in der Liste der Ladereihenfolgegruppen werden zuerst gestartet, gefolgt von Diensten in Gruppen, die nicht in der Liste der Lastenreihenfolgegruppen enthalten sind, gefolgt von Diensten, die keiner Gruppe angehören. Die Registrierung verfügt über eine Liste der Ladereihenfolgegruppen unter:
HKEY _ LOCAL _ MACHINE \ System \ CurrentControlSet \ Control \ ServiceGroupOrder
LoadOrderGroupDependencies [ In]
Array von Lastreihenfolgegruppen, 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 Skripts können Sie ein vbArray übergeben. Wenn der Zeiger NULL ist oder auf eine leere Zeichenfolge zeigt, weist der Dienst keine Abhängigkeiten auf. Gruppennamen muss das Zeichen SC GROUP _ _ IDENTIFIER (definiert in der Datei Winsvc.h) vorangestellt sein, um sie 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 mindestens ein Mitglied der Gruppe ausgeführt wird, nachdem versucht wurde, alle Mitglieder der Gruppe zu starten.
ServiceDependencies [ 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 skript können Sie ein 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ängig ist.
Rückgabewert
Gibt einen der in der folgenden Liste aufgeführten Werte oder einen anderen Wert zurück, um auf einen Fehler hindeuten zu können. Weitere Fehlercodes finden Sie unter WMI-Fehlerkonstistenzen 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 (State-Eigenschaft der Win32 _ BaseService-Klasse) gleich 0, 1 oder 2 ist.
-
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 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, von der dieser Dienst abhängig ist, 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 verfügt beim Start über zirkuläre Abhängigkeiten.
-
19
-
Ein Dienst wird unter demselben Namen ausgeführt.
-
20
-
Der Dienstname enthält ungültige Zeichen.
-
21
-
Ungültige Parameter wurden an den Dienst ü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
Dienste werden in der Regel auf zwei Arten installiert: entweder als Teil der Betriebssysteminstallation oder mithilfe eines vom Dienstentwickler bereitgestellten Installationsprogramms. Einige Dienste, insbesondere solche, die im Unternehmen erstellt wurden, verfügen jedoch möglicherweise nicht über ein Installationsprogramm. In diesen Fällen können Sie die Create-Methode verwenden, um Dienste programmgesteuert zu installieren.
Trotz des Namens erstellt die Create-Methode keinen Dienst. Es wird lediglich ein vorhandener Dienst installiert. Um diesen Befehl verwenden zu können, müssen Sie die ausführbare Datei des Diensts auf einen Computer kopieren und dann erstellen verwenden, um den Dienst zu installieren.
Die Create-Methode ähnelt der Change-Methode. In beiden Fällen werden die Eigenschaften des Diensts als Parameter an die -Methode übergeben. Wie bei den Parametern, die mit der Change-Methode verwendet werden, ist die Reihenfolge, in der diese Parameter übergeben werden, sehr wichtig.
Der LoadOrderGroup-Parameter stellt eine Gruppierung von Systemdiensten dar, die Ausführungsabhängigkeiten definieren. Die Dienste müssen in der von der Lastauftragsgruppe angegebenen Reihenfolge initiiert werden, da die Dienste voneinander abhängig sind. Diese abhängigen Dienste erfordern das Vorhandensein der voraussenten Dienste, damit sie ordnungsgemäß funktionieren.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Namespace |
\ \ CiMv2-Stammterminaldienste |
| MOF |
|
| DLL |
|