Win32_BaseService-Klasse

Artikel
06/12/2023

Die Win32_BaseService abstrakte WMI-Klasse stellt ausführbare Objekte dar, die in einer Registrierungsdatenbank installiert werden, die vom Service Control Manager verwaltet wird. Die ausführbare Datei, die einem Dienst zugeordnet ist, kann zum Startzeitpunkt von einem Startprogramm oder vom System gestartet werden. Sie kann auch bei Bedarf vom Dienststeuerungs-Manager gestartet werden. Jeder Dienst oder Prozess, der nicht im Besitz eines bestimmten Benutzers ist und eine Schnittstelle zu einigen Funktionen bereitstellt, die vom Computersystem unterstützt werden, ist ein Nachfolger (oder Member) dieser Klasse.

Beispiel: Der DHCP-Clientdienst (Dynamic Host Configuration Protocol) auf einem Computersystem, auf dem Windows Server ausgeführt wird.

Die folgende Syntax wurde aus MOF-Code (Managed Object Format, verwaltetes Objektformat) vereinfacht und enthält alle geerbten Eigenschaften. Eigenschaften werden in alphabetischer Reihenfolge und nicht in MOF-Reihenfolge aufgeführt.

Syntax

[SupportsCreate, CreateBy("Create"), SupportsDelete, DeleteBy("DeleteInstance"), Abstract, Provider("CIMWin32"), UUID("{8502C4C4-5FBB-11D2-AAC1-006008C78BC7}"), DisplayName("System Drivers and Services"), AMENDMENT]
class Win32_BaseService : CIM_Service
{
  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_BaseService-Klasse verfügt über folgende Membertypen:

Methoden
Eigenschaften

Methoden

Die Win32_BaseService-Klasse verfügt über diese Methoden.

Methode	BESCHREIBUNG
Veränderung	Ändert einen Dienst.
ChangeStartMode	Ändert den Startmodus eines Diensts.
Erstellen	Erstellt einen neuen Dienst.
Löschen	Löscht einen vorhandenen Dienst.
InterrogateService	Fordert an, dass der Dienst seinen Status an den Dienst-Manager aktualisiert.
PauseService	Versucht, den Dienst anzuhalten.
ResumeService	Versucht, den Dienst fortzusetzen.
Startservice	Versucht, den Dienst in den Startzustand zu versetzen.
StopService	Klassenmethode, die den Dienst im beendeten Zustand versetzt.
UserControlService	Versucht, einen benutzerdefinierten Steuerelementcode an einen Dienst zu senden.

Eigenschaften

Die Win32_BaseService-Klasse verfügt über diese Eigenschaften.

AcceptPause

Datentyp: boolean
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32API| Dienststrukturen| SERVICE_STATUS|dwControlsAccepted| SERVICE_ACCEPT_PAUSE_CONTINUE"), DisplayName ("Dienst akzeptiert Pause")

Der Dienst kann angehalten werden.

AcceptStop

Datentyp: boolean
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32API| Dienststrukturen| SERVICE_STATUS|dwControlsAccepted| SERVICE_ACCEPT_STOP"), DisplayName ("Service akzeptiert Stop")

Der Dienst kann beendet werden.

Caption

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen (64), DisplayName ("Caption")

Kurze Beschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

CreationClassName

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: CIM_Key, DisplayName ("Klassenname")

Name der ersten konkreten Klasse, die in der Vererbungskette angezeigt wird, die bei der Erstellung eines instance verwendet wird. Bei Verwendung mit den anderen Schlüsseleigenschaften der -Klasse ermöglicht die -Eigenschaft die eindeutige Identifizierung aller Instanzen dieser Klasse und ihrer Unterklassen.

Diese Eigenschaft wird von CIM_Service geerbt.

Beschreibung

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: DisplayName ("Description")

Eine Beschreibung des Objekts.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

DesktopInteract

Datentyp: boolean
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32API| Dienststrukturen| QUERY_SERVICE_CONFIG|dwServiceType| SERVICE_INTERACTIVE_PROCESS"), DisplayName ("Interagiert mit Desktop")

Der Dienst kann Fenster auf dem Desktop erstellen oder mit ihnen kommunizieren.

DisplayName

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32API| Dienststrukturen| QUERY_SERVICE_CONFIG|lpDisplayName"), DisplayName ("Anzeigename")

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

Einschränkungen: Akzeptiert denselben Wert wie die Name-Eigenschaft .

Beispiel: "Atdisk"

ErrorControl

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32API| Dienststrukturen| QUERY_SERVICE_CONFIG|dwErrorControl"), DisplayName ("Schweregrad des Startfehlers")

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

Ignore ("Ignore")

Der Benutzer wird nicht benachrichtigt.

Normal ("Normal")

Der Benutzer wird benachrichtigt.

Schwerwiegend ("schwerwiegend")

Das System wurde mit der letzten als fehlerfrei bekannten Konfiguration neu gestartet.

Kritisch ("Kritisch")

Das System versucht, mit einer fehlerfreien Konfiguration zu neu starten.

Unbekannt ("Unbekannt")

Die ausgeführte Aktion ist nicht angegeben.

ExitCode

Datentyp: uint32
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32API| Dienststrukturen| SERVICE_STATUS|dwWin32ExitCode"), DisplayName ("Exit Code")

Definieren von Problemen, die beim Starten oder Beenden des Diensts auftreten. Diese Eigenschaft wird auf ERROR_SERVICE_SPECIFIC_ERROR (1066) festgelegt, wenn der Fehler in Bezug auf den Dienst eindeutig ist, der durch diese Klasse repräsentiert wird, und Informationen zu dem Fehler stehen in der ServiceSpecificExitCode -Eigenschaft zur Verfügung. Der Dienst legt diesen Wert auf NO_ERROR fest, wenn ausgeführt wird, und erneut bei normaler Beendigung.

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_ManagedSystemElement geerbt.

Name

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Schlüssel

Eindeutiger Bezeichner des Diensts, der einen Hinweis auf die verwaltete Funktionalität bietet. Diese Funktionalität wird in der Description-Eigenschaft des Objekts ausführlicher beschrieben.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

PathName

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32API| Dienststrukturen| QUERY_SERVICE_CONFIG|lpBinaryPathName"), DisplayName ("Dateipfadname")

Vollqualifizierter Pfad zur Binärdatei des Diensts, die den Dienst implementiert.

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

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 von dieser Klasse dargestellt wird. Dieser Wert wird nur festgelegt, wenn der ExitCode-EigenschaftswertERROR_SERVICE_SPECIFIC_ERROR (1066) ist.

Servicetype

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32API| Dienststrukturen| QUERY_SERVICE_CONFIG|dwServiceType"), DisplayName ("Diensttyp")

Dienst, der für aufrufende Prozesse bereitgestellt wird.

Kerneltreiber ("Kerneltreiber")

Dateisystemtreiber ("Dateisystemtreiber")

Adapter ("Adapter")

Erkennungstreiber ("Erkennungstreiber")

Eigener Prozess ("Eigener Prozess")

Freigabeprozess ("Freigabeprozess")

Interaktiver Prozess ("Interaktiver Prozess")

Started

Datentyp: boolean
Zugriffstyp: Schreibgeschützt
Qualifizierer: DisplayName ("Started")

Der Dienst wurde gestartet.

Diese Eigenschaft wird von CIM_Service geerbt.

StartMode

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: Außerkraftsetzung ("StartMode"), DisplayName ("Startmodus")

Startmodus des Windows-Basisdiensts.

Diese Eigenschaft wird von CIM_Service geerbt.

Start ("Start")

Gerätetreiber, der vom Betriebssystemladeprogramm gestartet wird (gilt nur für Treiberdienste).

System ("System")

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

Auto ("Auto")

Dienst, der während des Systemstarts automatisch vom Dienststeuerungs-Manager gestartet werden soll.

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 ("Name des Startkontos")

Kontoname, unter dem der Dienst ausgeführt wird. Je nach Diensttyp kann der Kontoname im Format "Domänenname\Benutzername" oder im UPN-Format (Username@DomainName) 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".

State

Datentyp: string
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: MappingStrings ("Win32API| Dienststrukturen| SERVICE_STATUS|dwCurrentState "), DisplayName ("State")

Aktueller Status des Basisdiensts.

Beendet ("Beendet")

Start ausstehend ("Start ausstehend")

Ausstehend beenden ("Ausstehend")

Wird ausgeführt ("Wird ausgeführt")

Weiter ausstehend ("Weiter ausstehend")

Anhalten ausstehend ("Anhalten ausstehend")

Angehalten ("Angehalten")

Unbekannt ("Unbekannt")

Windows Server 2008 und Windows Vista: Diese Eigenschaft ist schreibgeschützt.

Status

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen (10), DisplayName ("Status")

Aktuelle status des Objekts. Es können verschiedene betriebs- und nicht-operative Status definiert werden. Zu den Betriebsstatus gehören: "OK", "Degraded" und "Pred Fail" (ein Element, z. B. ein SMART-fähiges Festplattenlaufwerk, funktioniert möglicherweise ordnungsgemäß, sagt aber einen Fehler in naher Zukunft voraus). Zu den nicht betriebsrelevanten Status zählen : "Error", "Starting", "Stop" und "Service". Letzteres, "Dienst", kann während Spiegel-Resilvering eines Datenträgers, beim Erneutladen einer Benutzerberechtigungsliste oder bei anderen Administrativen Arbeiten gelten. Nicht alle derartigen Arbeiten sind online, aber das verwaltete Element ist weder "OK" noch in einem der anderen Zuständen.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Folgende Werte sind gültig:

OK ("OK")

Fehler ("Fehler")

Degraded ("Degraded")

Unbekannt ("Unbekannt")

Pred Fail ("Pred Fail")

Starten ("Start")

Beenden ("Beenden")

Dienst ("Dienst")

Gestresst ("Gestresst")

NonRecover ("NonRecover")

Kein Kontakt ("Kein Kontakt")

Lost Comm ("Lost Comm")

SystemCreationClassName

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: Weitergegeben ("CIM_System. CreationClassName"), CIM_Key, DisplayName ("Systemklassenname")

Geben Sie den Namen des Systems ein, das diesen Dienst hostet.

Diese Eigenschaft wird von CIM_Service geerbt.

Systemname

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: Weitergegeben ("CIM_System. Name"), CIM_Key, DisplayName ("Systemname")

Name des Systems, das diesen Dienst hostet.

Diese Eigenschaft wird von CIM_Service geerbt.

TagId

Datentyp: uint32
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32API| Dienststrukturen| 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 Bestellen des Diensts star tup innerhalb einer Ladereihenfolgegruppe verwendet werden, indem ein Tagreihenfolgevektor in der Registrierung angegeben wird, die sich unter: HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\GroupOrderList befindet. Tags werden nur für Startdienste vom Kerneltreiber und Dateisystemtreiber ausgewertet, die über Start- oder Systemstartmodi verfügen.

Bemerkungen

Die Win32_BaseService-Klasse wird von CIM_Service abgeleitet.

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

CIM_Service
Betriebssystemklassen

Freigeben über

Win32_BaseService-Klasse

Syntax

Member

Methoden

Eigenschaften

Bemerkungen

Anforderungen

Siehe auch

Feedback

Zusätzliche Ressourcen