GetSecurityDescriptor-Methode der Win32_Service-Klasse (CIMWin32-WMI-Anbieter)
Die GetSecurityDescriptor-Methode gibt die Sicherheitsbeschreibung zurück, die den Zugriff auf den Dienst steuert. Die Beschreibung wird als Instanz von Win32_SecurityDescriptor zurückgegeben.
Syntax
uint32 GetSecurityDescriptor(
[out] Win32_SecurityDescriptor Descriptor
);
Parameter
-
Beschreibung [out]
-
Die dem Dienst zugeordnete Sicherheitsbeschreibung.
Rückgabewert
Gibt einen der in der folgenden Liste aufgeführten Werte oder einen anderen Wert zurück, um einen Fehler anzugeben. Weitere Fehlercodes finden Sie unter WMI-Fehlerkonstanten oder WbemErrorEnum. Allgemeine HRESULT-Werte finden Sie unter Systemfehlercodes.
-
Erfolgreich
-
0
Die Anforderung wurde akzeptiert.
-
1
Die Anforderung wird nicht unterstützt.
-
Zugriff verweigert
-
2
Der bzw. die Benutzer*in verfügte nicht über die erforderlichen Zugriffsberechtigungen.
-
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 Dienststatus (Win32_BaseService.State-Eigenschaft) 0, 1 oder 2 ist.
-
6
Der Dienst wurde nicht gestartet.
-
7
Der Dienst hat auf die Startanforderung nicht rechtzeitig reagiert.
-
Unbekannter Fehler
-
8
Unbekannter Fehler beim Starten des Diensts.
-
Rechte fehlen
-
9
Der Verzeichnispfad zur ausführbaren Datei des Diensts wurde nicht gefunden.
-
10
Der Dienst wird schon ausgeführt.
-
11
Die Datenbank zum Hinzufügen eines neuen Diensts ist gesperrt.
-
12
Eine für den Dienst erforderliche Abhängigkeit 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
Der Dienst wird aus dem System entfernt.
-
17
Der Dienst hat keinen Ausführungsthread.
-
18
Der Dienst verfügt beim Start über Ringabhängigkeiten.
-
19
Ein Dienst wird unter demselben Namen ausgeführt.
-
20
Der Dienstname enthält ungültige Zeichen.
-
Ungültiger Parameter
-
21
An den Dienst wurden ungültige Parameter übergeben.
-
22
Das Konto, unter dem der Dienst ausgeführt wird, ist entweder ungültig oder verfügt nicht über die erforderlichen 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.
-
Andere
-
22 4294967295
Hinweise
Die Instanz Win32_SecurityDescriptor stellt einen Datentyp SECURITY_DESCRIPTOR_CONTROL dar und enthält eine freigegebene Zugriffssteuerungsliste (Discretionary Access Control List, DACL) und eine System-Zugriffssteuerungsliste (System Access Control List, SACL). Weitere Informationen finden Sie unter Zugriffssteuerungslisten.
Wenn das SeSecurityPrivilege beim Abrufen einer Sicherheitsbeschreibung nicht gewährt oder aktiviert wird, wird nur die DACL in der zurückgegebenen Sicherheitsbeschreibung zurückgegeben. Weitere Informationen finden Sie unter Berechtigungskonstanten und Ausführen privilegierter Vorgänge.
Beispiele
Achten Sie beim Abrufen einer Sicherheitsbeschreibung in VBScript darauf, „Security“ zu verwenden und den Vorgang als Administrator*in auszuführen, wie im folgenden Codeausschnitt gezeigt. Andernfalls löst Ihr Code möglicherweise einen Berechtigungsfehler aus.
Set objWMIService = GetObject("winmgmts:" _
& "{impersonationLevel=impersonate, (Security)}!\\" & strComputer & "\root\cimv2")
Stellen Sie in VB.NET sicher, dass Sie „EnablePrivileges = True“ festlegen und die Anwendung als Administrator*in ausführen.
Scope = New ManagementScope([String].Format("\\{0}\root\CIMV2", ComputerName), Nothing)
Scope.Options.EnablePrivileges = True
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|