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 |
|
| DLL |
|