__Win32Provider-Klasse

Artikel
06/29/2023

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

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

Weitere Informationen

__Provider
WMI-Systemklassen
Registrieren eines Anbieters

Freigeben über

__Win32Provider-Klasse

Syntax

Member

Eigenschaften

Bemerkungen

Anforderungen

Weitere Informationen

Feedback

Zusätzliche Ressourcen