Win32 _ BaseService-Klasse

Die abstrakte WMI-Klasse Win32 _ BaseService stellt ausführbare Objekte dar, die in einer Registrierungsdatenbank installiert sind, die vom Dienststeuerungs-Manager verwaltet wird. Die einem Dienst zugeordnete ausführbare Datei kann zur Startzeit von einem Startprogramm oder vom System gestartet werden. Sie kann auch bedarfsgesteuerter vom Dienststeuerungs-Manager gestartet werden. Jeder Dienst oder Prozess, der sich nicht im Besitz eines bestimmten Benutzers befindet und eine Schnittstelle für einige 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;
};

Members

Die Win32 _ BaseService-Klasse verfügt über folgende Typen von Membern:

Methoden

Die Win32 _ BaseService-Klasse verfügt über diese Methoden.

Methode BESCHREIBUNG
Change Ä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 Zustand an den Dienst-Manager aktualisiert.
PauseService Versucht, den Dienst anzuhalten.
ResumeService Versucht, den Dienst fortzusetzen.
Startservice Versucht, den Dienst in den Startzustand zu bringen.
StopService Klassenmethode, die den Dienst in den Zustand "Beendet" versetzt.
UserControlService Versucht, einen benutzerdefinierten Steuerelementcode an einen Dienst zu senden.

Eigenschaften

Die Win32 _ BaseService-Klasse verfügt über diese Eigenschaften.

AcceptPause

Datentyp: boolescher Wert

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: 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.

Caption

Datentyp: String

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (64), DisplayName ("Caption")

Kurze Beschreibung des Objekts.

Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.

CreationClassName

Datentyp: String

Zugriffstyp: Schreibgeschützt

Qualifizierer: _ CIM-Schlüssel, DisplayName ("Klassenname")

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 die -Eigenschaft, dass alle Instanzen dieser Klasse und deren Unterklassen eindeutig identifiziert werden.

Diese Eigenschaft wird vom _ CIM-Dienstgeerbt.

Beschreibung

Datentyp: String

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Beschreibung")

Eine Beschreibung des Objekts.

Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.

DesktopInteract

Datentyp: boolescher Wert

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 beibehalten. Bei Vergleichen von DisplayName wird die Groß-/Kleinschreibung immer nicht beachtet.

Einschränkungen: Akzeptiert den gleichen 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.

Ignorieren ("Ignorieren")

Der Benutzer wird nicht benachrichtigt.

Normal ("Normal")

Der Benutzer wird benachrichtigt.

Schwerwiegend ("schwerwiegend")

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

Kritisch ("Kritisch")

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

Unbekannt ("Unbekannt")

Die aktionsspezifische Aktion ist nicht angegeben.

Exitcode

Datentyp: uint32

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API | Service Structures SERVICE | _ STATUS | dwWin32ExitCode"), DisplayName ("Exit Code")

Definieren von Problemen beim Starten oder Beenden des Diensts. Diese Eigenschaft wird auf ERROR _ SERVICE SPECIFIC _ _ ERROR (1066) festgelegt, wenn der Fehler für den durch diese Klasse dargestellten Dienst eindeutig ist und Informationen zum Fehler in der ServiceSpecificExitCode-Eigenschaft verfügbar sind. Der Dienst legt diesen Wert bei der Ausführung auf NO _ ERROR und bei normaler Beendigung erneut fest.

InstallDate

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("MIF. DMTF | ComponentID | 001.5"), DisplayName ("Installation date")

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: Zeichenfolge

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: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API | Service Structures QUERY SERVICE | _ _ CONFIG | lpBinaryPathName"), DisplayName ("Dateipfadname")

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

Beispiel: \ "SystemRoot \ \ System32-Treiber \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 von dieser Klasse dargestellten Dienst definiert. Dieser Wert wird nur festgelegt, wenn der ExitCodeproperty-Wert ERROR SERVICE SPECIFIC _ _ _ ERROR (1066) ist.

ServiceType

Datentyp: Zeichenfolge

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")

Recognizer Driver ("Recognizer Driver")

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-Dienst _ geerbt.

StartMode

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Außerkraftsetzung ("StartMode"), DisplayName ("Startmodus")

Startmodus des Windows Basisdiensts.

Diese Eigenschaft wird vom CIM-Dienst _ geerbt.

Start ("Boot")

Vom Betriebssystemlader gestarteter Gerätetreiber (nur für Treiberdienste gültig).

System ("System")

Der Gerätetreiber wurde durch den Initialisierungsprozess des Betriebssystems gestartet. Dieses Wert ist nur für Treiberdienste gültig.

Auto ("Auto")

Der Dienst wird automatisch vom Dienststeuerungs-Manager während des Systemstarts gestartet.

Manuell (manuell)

Der 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: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("Win32API | Service Structures QUERY SERVICE | _ _ CONFIG | lpServiceStartName"), DisplayName ("Starting Account Name")

Kontoname, unter dem der Dienst ausgeführt wird. Je nach Diensttyp kann der Kontoname das Format "DomainName Username" oder \ das UPN-Format ( ) Username@DomainName haben. Der Dienstprozess wird mit einer dieser beiden Formen protokolliert, wenn er ausgeführt wird. Wenn das Konto zur integrierten Domäne gehört, ". \ Benutzername" kann angegeben werden. Wenn NULL angegeben wird, wird der Dienst als LocalSystem-Konto angemeldet. Für Treiber 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 wird, wird der Treiber außerdem mit einem Standardobjektnamen ausgeführt, der vom E/A-System basierend auf dem Dienstnamen erstellt wird. Beispiel: "DWDOM \ Admin".

State

Datentyp: Zeichenfolge

Zugriffstyp: Lesen/Schreiben

Qualifizierer: MappingStrings ("Win32API | Service Structures SERVICE | _ STATUS | dwCurrentState "), DisplayName ("State")

Aktueller Status des Basisdiensts.

Beendet ("Beendet")

Start ausstehend ("Start ausstehend")

Ausstehend beenden ("Ausstehend beenden")

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

Weiter ausstehend ("Weiter ausstehend")

Anhalten ausstehend ("Ausstehend anhalten")

Angehalten ("Angehalten")

Unbekannt ("Unbekannt")

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

Status

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (10), DisplayName ("Status")

Aktueller Status des Objekts. Es können verschiedene Betriebs- und Nichtoperationsstatus definiert werden. Betriebsstatus: "OK", "Heruntergestuft" und "Pred Fail" (ein Element, z. B. ein SMART-fähiges Festplattenlaufwerk, funktioniert möglicherweise ordnungsgemäß, sagt aber einen Fehler in naher Zukunft vorher). Nichtoperationale Status: "Error", "Starting", "Stopping" und "Service". Letzteres, "Dienst", kann beim Spiegelungsresilvering eines Datenträgers, beim erneuten Laden einer Benutzerberechtigungsliste oder bei anderen administrativen Arbeiten angewendet werden. Nicht alle dieser Arbeiten sind online, aber das verwaltete Element ist weder "OK" noch in einem der anderen Zustände.

Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.

Folgende Werte sind gültig:

OK ("OK")

Fehler ("Fehler")

Heruntergestuft ("Heruntergestuft")

Unbekannt ("Unbekannt")

Pred Fail ("Pred Fail")

Wird gestartet ("Wird gestartet")

Beenden ("Wird beendet")

Dienst ("Dienst")

Mannslast ("1000")

NonRecover ("NonRecover")

Kein Kontakt ("Kein Kontakt")

Verlorenes Komma ("Verlorenes Komma")

SystemCreationClassName

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: Weitergegeben ("_ CIM-System.CreationClassName"), _ CIM-Schlüssel, DisplayName ("Systemklassenname")

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

Diese Eigenschaft wird vom _ CIM-Dienstgeerbt.

Systemname

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: Weitergegeben ("_ CIM-System.Name"), _ CIM-Schlüssel, DisplayName ("Systemname")

Name des Systems, das diesen Dienst hostet.

Diese Eigenschaft wird vom _ CIM-Dienstgeerbt.

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 Sortieren des Dienst-Sternchens innerhalb einer Lastreihenfolgegruppe verwendet werden, indem in der Registrierung unter HKEY _ LOCAL _ MACHINE System \ \ CurrentControlSet \ Control \ GroupOrderList ein Tagreihenfolgevektor angegeben wird. Tags werden nur für Starttypdienste des Kerneltreibers und Dateisystemtreibers ausgewertet, die den Start- oder Systemstartmodus aufweisen.

Bemerkungen

Die Win32 _ BaseService-Klasse wird vom _ CIM-Dienstabgeleitet.

Requirements (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

Weitere Informationen

_CIM-Dienst

Betriebssystemklassen