Win32 _ SystemDriver-Klasse
Die WMI-Klasse _ Win32 SystemDriver stellt den Systemtreiber für einen Basisdienst dar.
Die folgende Syntax wurde aus MOF-Code (Managed Object Format, verwaltetes Objektformat) vereinfacht und enthält alle geerbten Eigenschaften. Eigenschaften und Methoden sind in alphabetischer Reihenfolge und nicht in MOF-Reihenfolge.
Syntax
[Dynamic, Provider("CIMWin32"), SupportsUpdate, UUID("{8502C4C5-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_SystemDriver : Win32_BaseService
{
boolean AcceptPause;
boolean AcceptStop;
string Caption;
string CreationClassName;
string Description;
boolean DesktopInteract;
string DisplayName;
string ErrorControl;
uint32 ExitCode;
datetime InstallDate;
string Name;
string PathName;
uint32 ServiceSpecificExitCode;
string ServiceType;
boolean Started;
string StartMode;
string StartName;
string State;
string Status;
string SystemCreationClassName;
string SystemName;
uint32 TagId;
};
Member
Die Win32 _ SystemDriver-Klasse verfügt über die folgenden Membertypen:
Methoden
Die Win32 _ SystemDriver-Klasse verfügt über diese Methoden.
| Methode | Beschreibung |
|---|---|
| Change | Klassenmethode, die einen Dienst ändert. |
| ChangeStartMode | Klassenmethode, die den Startmodus eines Diensts ändert. |
| Erstellen | Klassenmethode, die einen neuen Dienst erstellt. |
| Löschen | Klassenmethode, die einen vorhandenen Dienst löscht. |
| InterrogateService | Klassenmethode, die an fordert, dass der Dienst seinen Zustand an den Service Manager aktualisiert. |
| PauseService | Klassenmethode, die versucht, den Dienst in den angehaltenen Zustand zu platzieren. |
| ResumeService | Klassenmethode, die versucht, den Dienst in den fortgesetzten Zustand zu platzieren. |
| Startservice | Klassenmethode, die versucht, den Dienst in seinen Startzustand zu platzieren. |
| StopService | Klassenmethode, die den Dienst in den beendeten Zustand setzt. |
| UserControlService | Klassenmethode, die versucht, einen benutzerdefinierten Steuerelementcode an einen Dienst zu senden. |
Eigenschaften
Die Win32 _ SystemDriver-Klasse verfügt über diese Eigenschaften.
-
AcceptPause
-
-
Datentyp: boolescher Wert
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("Win32API | Service Structures SERVICE | _ STATUS | dwControlsAccepted | SERVICE ACCEPT PAUSE _ _ _ CONTINUE"), DisplayName ("Service Accepts Pause")
Der Dienst kann angehalten werden.
Diese Eigenschaft wird von Win32 _ BaseService geerbt.
-
-
AcceptStop
-
-
Datentyp: boolescher Wert
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("Win32API | Service Structures SERVICE | _ STATUS | dwControlsAccepted | SERVICE ACCEPT _ _ STOP"), DisplayName ("Service Accepts Stop")
Der Dienst kann beendet werden.
Diese Eigenschaft wird von Win32 _ BaseService geerbt.
-
-
Caption
-
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen (64), DisplayName ("Caption")
Kurze Beschreibung des Objekts.
Diese Eigenschaft wird von CIM _ ManagedSystemElement geerbt.
-
-
CreationClassName
-
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: _ CIM-Schlüssel, DisplayName ("Klassenname")
Der Name der ersten konkreten Klasse, die in der Vererbungskette angezeigt wird, die bei der Erstellung einer -Instanz verwendet wird. Bei Verwendung mit den anderen Schlüsseleigenschaften der -Klasse ermöglicht diese Eigenschaft, dass alle Instanzen dieser Klasse und deren Unterklassen eindeutig identifiziert werden.
Diese Eigenschaft wird vom CIM-Dienst _ geerbt.
-
-
Beschreibung
-
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: DisplayName ("Description")
Eine Beschreibung des Objekts.
Diese Eigenschaft wird von CIM _ ManagedSystemElement geerbt.
-
-
DesktopInteract
-
-
Datentyp: boolescher Wert
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("Win32API-Dienststrukturen | QUERY SERVICE | _ _ CONFIG | dwServiceType | SERVICE INTERACTIVE _ _ PROCESS"), DisplayName ("Interagiert mit Desktop")
Dieser Dienst kann Fenster auf dem Desktop erstellen oder mit ihnen kommunizieren.
Diese Eigenschaft wird von Win32 _ BaseService geerbt.
-
-
DisplayName
-
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("Win32API | Service Structures QUERY SERVICE | _ _ CONFIG | lpDisplayName"), DisplayName ("Display Name")
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 die Name-Eigenschaft.
Beispiel: "Atdisk"
Diese Eigenschaft wird von Win32 _ BaseService geerbt.
-
-
ErrorControl
-
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("Win32API-Dienststrukturen | QUERY SERVICE | _ _ CONFIG | dwErrorControl"), DisplayName ("Schweregrad des Startfehlers")
Schweregrad des Fehlers, wenn dieser Dienst während des Starts nicht gestartet werden kann. Dieser Wert gibt die Aktion an, die vom Startprogramm ausgeführt wird, wenn ein Fehler auftritt. Alle Fehler werden vom Computersystem protokolliert.
Diese Eigenschaft wird von Win32 _ BaseService geerbt.
-
-
Ignorieren ("Ignorieren")
-
Der Benutzer wird nicht benachrichtigt.
-
Normal ("Normal")
-
Der Benutzer wird benachrichtigt.
-
Schwerwiegend ("schwerwiegend")
-
Das System wird mit der letzten bekannten, fehlerfreien Konfiguration neu gestartet.
-
Kritisch ("Kritisch")
-
Das System versucht, mit einer fehlerfreien Konfiguration zu neu starten.
-
Unbekannt ("Unbekannt")
-
Die Ursache des Fehlers ist unbekannt.
Exitcode
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("Win32API-Dienststrukturen | | SERVICE _ STATUS | dwWin32ExitCode"), DisplayName ("Exitcode")
Windows Fehlercode, der probleme beim Starten oder Beenden des Diensts definiert. Diese Eigenschaft wird auf ERROR _ SERVICE SPECIFIC _ _ ERROR (1066) festgelegt, wenn der Fehler für den von dieser Klasse dargestellten Dienst eindeutig ist und Informationen zum Fehler in der ServiceSpecificExitCode-Eigenschaft verfügbar sind. Der Dienst legt diesen Wert auf NO _ ERROR fest, wenn er ausgeführt wird, und wieder bei normaler Beendigung.
Diese Eigenschaft wird von Win32 _ BaseServicegeerbt.
InstallDate
-
Datentyp: datetime
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("MIF. DMTF | ComponentID | 001.5"), DisplayName ("Installationsdatum")
Das Objekt wurde installiert. Diese Eigenschaft benötigt keinen Wert, um anzugeben, dass das Objekt installiert ist.
Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.
Name
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schlüssel
Eindeutiger Bezeichner für den Dienst, der einen Hinweis auf die verwaltete Funktionalität bietet. Diese Funktionalität wird in der Eigenschaft Beschreibung des Objekts ausführlicher beschrieben.
Diese Eigenschaft wird vom _ CIM-Dienstgeerbt.
PathName
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("Win32API-Dienststrukturen | QUERY SERVICE | _ _ CONFIG | lpBinaryPathName"), DisplayName ("Dateipfadname")
Vollqualifizierte Pfad zur Binärdatei des Diensts, die den Dienst implementiert.
Beispiel: \ "SystemRoot \ \ System32-Treiber \afd.sys"
Diese Eigenschaft wird von Win32 _ BaseServicegeerbt.
ServiceSpecificExitCode
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("Win32API-Dienststrukturen | | SERVICE _ STATUS | dwServiceSpecificExitCode"), DisplayName ("Serverspezifischer Exitcode")
Dienstspezifischer Fehlercode für Fehler, die auftreten, während der Dienst gestartet oder beendet wird. Die Exitcodes werden durch den Dienst definiert, der durch diese Klasse dargestellt wird. Dieser Wert wird nur festgelegt, wenn der ExitCode-Eigenschaftswert ERROR SERVICE SPECIFIC _ _ _ ERROR (1066) lautet.
Diese Eigenschaft wird von Win32 _ BaseServicegeerbt.
ServiceType
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("Win32API-Dienststrukturen | QUERY SERVICE | _ _ CONFIG | dwServiceType"), DisplayName ("Diensttyp")
Der für aufrufende Prozesse bereitgestellte Diensttyp.
Diese Eigenschaft wird von Win32 _ BaseServicegeerbt.
Die Werte sind:
Kerneltreiber ("Kerneltreiber")
Dateisystemtreiber ("Dateisystemtreiber")
Adapter ("Adapter")
Erkennungstreiber ("Erkennungstreiber")
Eigener Prozess ("Eigener Prozess")
Freigabeprozess ("Freigabeprozess")
Interaktiver Prozess ("interaktiver Prozess")
Begann
-
Datentyp: boolescher Wert
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: DisplayName ("Started")
Der Dienst wurde gestartet.
Diese Eigenschaft wird vom _ CIM-Dienstgeerbt.
StartMode
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: DisplayName ("Startmodus")
Startmodus des Systemtreibers.
Diese Eigenschaft wird von Win32 _ BaseServicegeerbt.
Start ("Boot")
Vom Betriebssystemladeprogramm gestarteter Gerätetreiber (nur für Treiberdienste gültig).
System ("System")
Der Vom Initialisierungsprozess des Betriebssystems gestartete Gerätetreiber. Dieses Wert ist nur für Treiberdienste gültig.
Auto ("Auto")
Der Dienst wird während des Systemstarts automatisch vom Dienststeuerungs-Manager gestartet.
Manuell ("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.
StartName
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("Win32API-Dienststrukturen | QUERY SERVICE | _ _ CONFIG | lpServiceStartName"), DisplayName ("Startkontoname")
Kontoname, unter dem der Dienst ausgeführt wird. Je nach Diensttyp kann der Kontoname die Form DomainName \ Username aufweisen. 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 Kernel- oder Treiber auf Systemebene enthält StartName den Namen des Treiberobjekts (d. \ h. FileSystem \ Rdr oder \ Driver \ Xns), den das Ein- und Ausgabesystem (E/A) zum Laden des Gerätetreibers verwendet. Wenn NULL angegeben wird, wird der Treiber außerdem mit einem Standardobjektnamen ausgeführt, der vom E/A-System basierend auf dem Dienstnamen erstellt wurde.
Beispiel: "DWDOM \ Admin"
Diese Eigenschaft wird von Win32 _ BaseServicegeerbt.
State
-
Datentyp: string
-
Zugriffstyp: Lesen/Schreiben
-
Qualifizierer: MappingStrings ("Win32API-Dienststrukturen | | SERVICE _ STATUS | dwCurrentState "), DisplayName ("State")
Aktueller Status des Basisdiensts.
Diese Eigenschaft wird von Win32 _ BaseServicegeerbt.
Die Werte sind:
Beendet ("Beendet")
Ausstehend starten ("Start ausstehend")
Stop Pending ("Stop Pending")
Wird ausgeführt ("Wird ausgeführt")
Weiter ausstehend ("Weiter ausstehend")
Anhalten ausstehend ("Ausstehend anhalten")
Angehalten ("Angehalten")
Unbekannt ("Unbekannt")
Status
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen (10), DisplayName ("Status")
Aktueller Status des Objekts. Es können verschiedene betriebsbereite und nicht betriebsbereite Status definiert werden. Folgende Betriebsstatus sind möglich: "OK", "Heruntergestuft" und "Fehler vor dem Ausfall" (ein Element, z. B. ein SMART-fähiges Festplattenlaufwerk, funktioniert möglicherweise ordnungsgemäß, aber es wird in naher Zukunft ein Fehler vorhergesagt). Nicht operative Status sind: "Error", "Starting", "Stopping" und "Service". Letzteres, "Dienst", kann während der Spiegelung eines Datenträgers, beim erneuten Laden einer Benutzerberechtigungsliste oder bei anderen administrativen Aufgaben angewendet werden. Nicht alle derartigen Arbeiten sind online, aber das verwaltete Element ist weder "OK" noch in einem der anderen Zustände.
Diese Eigenschaft wird von CIM _ ManagedSystemElement geerbt.
Die Werte sind:
OK ("OK")
Fehler ("Fehler")
Heruntergestuft ("Heruntergestuft")
Unbekannt ("Unbekannt")
Pred Fail ("Pred Fail")
Wird gestartet ("Wird gestartet")
Wird beendet ("Wird beendet")
Dienst ("Dienst")
Striche ("Strich")
NonRecover ("NonRecover")
Kein Kontakt ("Kein Kontakt")
Lost Comm ("Lost Comm")
SystemCreationClassName
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Propagated ("_ CIM-System.CreationClassName"), _ CIM-Schlüssel, DisplayName ("Systemklassenname")
Geben Sie den Namen des Systems ein, das diesen Dienst hostet.
Diese Eigenschaft wird vom CIM-Dienst _ geerbt.
Systemname
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Propagated ("_ CIM-System.Name"), _ CIM-Taste, DisplayName ("Systemname")
Name des Systems, das diesen Dienst hostet.
Diese Eigenschaft wird vom CIM-Dienst _ geerbt.
TagId
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("Win32API | Service Structures QUERY SERVICE | _ _ CONFIG | dwTagId"), DisplayName ("Tag Id")
Eindeutiger Tagwert für diesen Dienst in der Gruppe. Der Wert 0 (null) gibt an, dass dem Dienst kein Tag zugewiesen wurde. Ein Tag kann zum Starten des Bestelldiensts innerhalb einer Lastauftragsgruppe verwendet werden, indem ein Tag-Reihenfolgenvektor in der Registrierung unter angegeben wird:
Diese Eigenschaft wird von Win32 _ BaseService geerbt.
HKEY _ LOCAL _ MACHINE \ System \ CurrentControlSet-Steuerelement \ \ GroupOrderList.
Tags werden nur für Kerneltreiber- und Dateisystemtreiber-Startdienste ausgewertet, die den Startmodus "Start" oder "System" haben.
Hinweise
Die Win32 _ SystemDriver-Klasse wird von Win32 _ BaseService abgeleitet.
Beispiele
Das VBScript-Beispiel Systemtreiber auflisten Zeigt installierte Systemtreiber in einer HTML-Datei an.
Das folgende PowerShell-Beispiel ruft eine Reihe von Eigenschaften von den ausgeführten Systemtreibern auf einem Computer ab.
Get-WmiObject -Class Win32_SystemDriver | Where-Object -FilterScript {$_.State -eq "Running"} | Where-Object -FilterScript {$_.StartMode -eq "Manual"} | Format-Table -Property Name,DisplayName
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Namespace |
\Stamm-CIMV2 |
| MOF |
|
| DLL |
|