__Win32Provider-Klasse
Die Systemklasse __Win32Provider registriert Informationen zur physischen Implementierung eines Anbieters in WMI. Anbieter, bei denen die Eigenschaft HostingModel nicht festgelegt ist, werden standardmäßig zur Ausführung als NetworkServiceHostOrSelfHost in einem Wmiprvse.exe-Prozess geladen.
Die folgende Syntax wird durch MOF-Code (Managed Object Format) vereinfacht und schließt alle geerbten Eigenschaften ein. Eigenschaften werden in alphabetischer Reihenfolge aufgeführt, nicht in MOF-Reihenfolge.
Syntax
class __Win32Provider : __Provider
{
string ClientLoadableCLSID;
string CLSID;
sint32 Concurrency;
string DefaultMachineName;
boolean Enabled;
string HostingModel;
sint32 ImpersonationLevel = 0;
sint32 InitializationReentrancy;
datetime InitializationTimeoutInterval;
boolean InitializeAsAdminFirst;
string Name;
datetime OperationTimeoutInterval;
boolean PerLocaleInitialization = FALSE;
boolean PerUserInitialization = FALSE;
boolean Pure = TRUE;
string SecurityDescriptor;
boolean SupportsExplicitShutdown;
boolean SupportsExtendedStatus;
boolean SupportsQuotas;
boolean SupportsSendStatus;
boolean SupportsShutdown;
boolean SupportsThrottling;
datetime UnloadTimeout;
uint32 Version;
};
Member
Die __Win32Provider-Klasse verfügt über die folgenden Membertypen:
Eigenschaften
Die __Win32Provider-Klasse verfügt über diese Eigenschaften.
-
ClientLoadableCLSID
-
-
Datentyp: string
-
Zugriffstyp: Lesen/Schreiben
Eine von WMI verwendete Klassen-ID, anhand derer bestimmt wird, ob ein Hochleistungsanbieter in den Client- oder WMI-Prozess geladen werden soll oder nicht. Wenn sich Anbieter und Client auf demselben Computer befinden, lädt WMI den Anbieter prozessintern auf den Client, indem es ClientLoadableCLSID als Klassen-ID verwendet. Befinden sich Anbieter und Client auf unterschiedlichen Computern, lädt WMI den Anbieter prozessintern in WMI. WMI verwendet außerdem ClientLoadableCLSID, um Aktualisierungsvorgänge zu unterstützen.
Weitere Informationen finden Sie unter Registrieren eines Hochleistungsanbieters.
-
-
CLSID
-
-
Datentyp: string
-
Zugriffstyp: Lesen/Schreiben
GUID, die die Klassen-ID (CLSID) des Anbieter-COM-Objekts repräsentiert. Dieses COM-Objekt muss eine Implementierung der Schnittstelle IWbemProviderInit enthalten.
-
-
Concurrency
-
-
Datentyp: sint32
-
Zugriffstyp: Lesen/Schreiben
Wird nicht verwendet.
-
-
DefaultMachineName
-
-
Datentyp: string
-
Zugriffstyp: Lesen/Schreiben
Gibt den Computer an, auf dem der Anbieter gestartet werden soll. Wenn der Anbieter auf dem lokalen Computer ausgeführt wird, lautet der Wert NULL.
-
-
Aktiviert
-
-
Datentyp: boolean
-
Zugriffstyp: Lesen/Schreiben
Bei einer Festlegung auf TRUE ist diese Instanz aktiviert und kann für die Bearbeitung von Clientanforderungen verwendet werden.
-
-
HostingModel
-
-
Datentyp: string
-
Zugriffstyp: Lesen/Schreiben
Diese Eigenschaft setzt sich aus Werten der Eigenschaften MSFT_ProvidersHostingGroup und HostingSpecification zusammen. Der Wert dieser Eigenschaft gibt an, wie WMI den Anbieter lädt und mit welchem Sicherheitskonto er ausgeführt wird. Weitere Informationen zum Festlegen der Eigenschaft HostingModel finden Sie unter Anbieterhosting und Sicherheit und Registrieren eines Anbieters.
-
-
ImpersonationLevel
-
-
Datentyp: sint32
-
Zugriffstyp: Lesen/Schreiben
Reserviert. Der Standardwert ist 0 (null).
-
-
InitializationReentrancy
-
-
Datentyp: sint32
-
Zugriffstyp: Lesen/Schreiben
Eine Reihe von Flags, die Informationen zur Serialisierung bereitstellen. Der Standardwert ist 0 (null).
-
-
0
-
Die gesamte Initialisierung dieses Anbieters muss serialisiert werden.
-
1
-
Alle Initialisierungen dieses Anbieters im selben Namespace müssen serialisiert werden.
-
2
-
Es ist keine Serialisierung der Initialisierung erforderlich.
InitializationTimeoutInterval
-
Datentyp: datetime
-
Zugriffstyp: Lesen/Schreiben
Wird nicht verwendet.
InitializeAsAdminFirst
-
Datentyp: boolean
-
Zugriffstyp: Lesen/Schreiben
TBD
Name
-
Datentyp: string
-
Zugriffstyp: Lesen/Schreiben
-
Qualifizierer: Key
Der Anbietername.
OperationTimeoutInterval
-
Datentyp: datetime
-
Zugriffstyp: Lesen/Schreiben
Wird nicht verwendet.
PerLocaleInitialization
-
Datentyp: boolean
-
Zugriffstyp: Lesen/Schreiben
Bei einer Festlegung auf TRUE wird der Anbieter für jedes Gebietsschema initialisiert, wenn sich Benutzer*innen mehrmals über verschiedene Gebietsschemata mit demselben Namespace verbinden. Der Standardwert ist FALSE.
PerUserInitialization
-
Datentyp: boolean
-
Zugriffstyp: Lesen/Schreiben
Bei einer Festlegung auf TRUE wird der Anbieter für alle NTLM-Benutzer*innen (NT LAN Manager), die Anforderungen an den Anbieter richten, einmalig initialisiert. Bei einer Festlegung auf FALSE (Standard) wird der Anbieter einmalig für alle Benutzer*innen initialisiert.
Pure
-
Datentyp: boolean
-
Zugriffstyp: Lesen/Schreiben
Bei einer Festlegung auf TRUE bereitet der Anbieter das Entladen vor, indem er IUnknown::Release für alle ausstehenden Schnittstellenpunkte aufruft, wenn WMI die Release-Methode seiner primären Schnittstelle aufruft. Anbieter, die weiterhin Clients von WMI bleiben müssen, nachdem sie nicht mehr als Anbieter fungieren, sollten Pure auf FALSE festlegen. Die Standardeinstellung lautet TRUE. Weitere Informationen finden Sie in diesem Thema im Abschnitt „Hinweise“.
SecurityDescriptor
-
Datentyp: string
-
Zugriffstyp: Lesen/Schreiben
Sicherheitsbeschreibung in SDDL (Security Descriptor Definition Language), die den Satz von Benutzer*innen bestimmt, die erfolgreich IWbemDecoupledRegistrar:Register für den entkoppelten Anbieter aufrufen können. Weitere Informationen finden Sie im Thema Security Descriptor Definition Language (SDDL) im Abschnitt „Sicherheit“ des Windows SDK. Diese Sicherheitsbeschreibung wird nur für entkoppelte Anbieter verwendet und hat keine Auswirkungen auf andere Anbieter. Weitere Informationen finden Sie unter Integrieren eines Anbieters in eine Anwendung.
WMI führt Zugriffsüberprüfungen für entkoppelte Anbieter durch, bei denen die Schnittstellen IWbemProviderInit und IWbemObjectSink verwendet werden. Wenn die Sicherheitsbeschreibung NULL lautet, dann können nur Anwendungen oder Dienste einen entkoppelten Anbieter ausführen, die unter den Konten „LocalSystem“, „NetworkService“ oder „LocalService“ betrieben werden.
Die folgende Zeichenfolge zeigt einen entkoppelten Anbieter, der nur von integrierten Administratoren ausgeführt werden kann. "O:BAG:BAD:(A;;0x1;;;;BA)"
Weitere Informationen zum Festlegen der SecurityDescriptor-Eigenschaft finden Sie unter Verwalten der WMI-Sicherheit.
SupportsExplicitShutdown
-
Datentyp: boolean
-
Zugriffstyp: Lesen/Schreiben
Wird nicht verwendet.
SupportsExtendedStatus
-
Datentyp: boolean
-
Zugriffstyp: Lesen/Schreiben
Wird nicht verwendet.
SupportsQuotas
-
Datentyp: boolean
-
Zugriffstyp: Lesen/Schreiben
Wird nicht verwendet.
SupportsSendStatus
-
Datentyp: boolean
-
Zugriffstyp: Lesen/Schreiben
Wird nicht verwendet.
SupportsShutdown
-
Datentyp: boolean
-
Zugriffstyp: Lesen/Schreiben
Wird nicht verwendet.
SupportsThrottling
-
Datentyp: boolean
-
Zugriffstyp: Lesen/Schreiben
Wird nicht verwendet.
UnloadTimeout
-
Datentyp: datetime
-
Zugriffstyp: Lesen/Schreiben
Datums- und Uhrzeitformat, das angibt, wie lange WMI dem Anbieter gestattet, im Leerlauf zu bleiben, bevor er entladen wird. In der Regel fordern Anbieter an, dass WMI nicht länger als fünf Minuten wartet.
Für die aktuelle Version von WMI wird der Wert dieser Eigenschaft ignoriert. WMI entlädt den Anbieter basierend auf dem Timeoutwert in einer internen Klasse im \root-Namespace. Es wird empfohlen, dass Anbieter UnloadTimeout festlegen. Weitere Informationen finden Sie unter Entladen eines Anbieters.
Version
-
Datentyp: uint32
-
Zugriffstyp: Lesen/Schreiben
Version des Anbieters. Die unterstützten Versionen sind 1 und 2. Version 2 verstärkt die Gültigkeitsprüfungen für alle zugehörigen Eigenschaftsregistrierungen, insbesondere für die Eigenschaft ImpersonationLevel.
Bemerkungen
Die Klasse __Win32Provider ist von __Provider abgeleitet.
Die meisten Anbieter können die Standardwerte für die Eigenschaft InitializationReentrancy akzeptieren. Wenn ein Anbieter jedoch die gleichzeitige Initialisierung für verschiedene Benutzer*innen unterstützt, kann diese Eigenschaft auf 1 festgelegt werden. Wenn eine serialisierte Initialisierung erforderlich ist, wird für InitializationReentrancy der Wert 0 beibehalten. In beiden Fällen ist PerUserInitialization auf TRUE festgelegt.
Ein reiner Anbieter bzw. ein Anbieter, für den die Eigenschaft Pure auf TRUE festlegt ist, existiert nur, um Anforderungen von Anwendungen und WMI zu verarbeiten. Die meisten Anbieter sind reine Anbieter. Nicht als „Pure“ festgelegte Anbieter sind die Ausnahme. Sie wechseln in die Rolle des Clients, nachdem sie die Anforderungen verarbeitet haben.
Ein Beispiel für einen nicht reinen Anbieter ist ein Pushanbieter, der mit der Ausgabe von Abfragen beginnt und nach Abschluss der Initialisierung Anforderungen an WMI sendet. Ein Pushanbieter hat nur die Aufgabe, das CIM-Repository zum Zeitpunkt der Initialisierung mit Daten zu aktualisieren. Nach der Aktualisierung des Repositorys kann ein Pushanbieter darauf warten, entladen zu werden, oder in die Rolle des Clients wechseln. Der Pushanbieter, der auf das Entladen wartet, ist ein reiner Anbieter. Der Pushanbieter, der an Clientaktivitäten teilnimmt, ist kein reiner Anbieter.
WMI muss in der Lage sein, zwischen reinen Anbietern und nicht reinen Anbietern zu unterscheiden, damit ermittelt werden kann, wann ein sicheres Herunterfahren möglich ist. WMI muss auf den Abschluss aller Vorgänge warten, an denen nicht reine Anbieter beteiligt sind, bevor es sicher heruntergefahren werden kann.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) |
Windows Vista |
Unterstützte Mindestversion (Server) |
Windows Server 2008 |
Namespace |
Alle WMI-Namespaces |