Win32 _ SystemDriver-Klasse

Die WMI-Klasse _ Win32 SystemDriverstellt 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
CIMWin32.mof
DLL
CIMWin32.dll

Siehe auch

Win32 _ BaseService

Betriebssystemklassen