Win32_BaseService-Klasse

  • Artikel

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

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