Anbieterklasse (provider.h)

[Die Provider-Klasse ist Teil des WMI-Provider-Frameworks, das nun als endgültig betrachtet wird, und es sind keine weiteren Entwicklungen, Verbesserungen oder Updates für nicht sicherheitsrelevante Probleme verfügbar, die diese Bibliotheken betreffen. Die MI-APIs sollten für alle Neuentwicklungen verwendet werden.]

Die Provider-Klasse ist die Basisklasse für die Klasse oder Klassen, die vom Frameworkanbieter unterstützt werden. Die Provider-Klasse kapselt Implementierungen der Methoden von IWbemServices und enthält mehrere Hilfsfunktionen. Ein Frameworkanbieter überschreibt eine der Methoden der Provider-Klasse für jedes feature, das er unterstützt. Beispielsweise überschreibt ein Anbieter, der die Abfrageverarbeitung unterstützt, die Provider::ExecQuery-Methode .

Für jede WMI-Klasse, die über einen Frameworkanbieter verfügt, wird ein instance der Provider-Klasse erstellt.

Der Anbieter verfügt über folgende Membertypen:

Methode	BESCHREIBUNG
Commit	Gibt den aktuellen instance an WMI zurück.
CreateNewInstance	Weist ein neues CInstance-Objekt zu und gibt einen Zeiger darauf zurück.
DeleteInstance	Löscht einen instance. Wird von WMI aufgerufen.
EnumerateInstances	Ruft alle Instanzen der Klasse eines Frameworkanbieters ab. Wird von WMI aufgerufen.
ExecMethod	Ruft eine Methode für eine Klasse oder instance auf. Wird von WMI aufgerufen.
ExecQuery	Verarbeitet eine WMI-Abfrage (WMI Query Language, WQL). Wird von WMI aufgerufen.
Leerung	Wird vom Anbieterframework aufgerufen, um den gesamten nicht benötigten Arbeitsspeicher zu löschen, der vom Anbieter verwendet wird.
GetLocalComputerName	Gibt einen konstanten Verweis auf den Computernamen im CHString-Format zurück.
GetLocalInstancePath	Versucht, einen vollständigen Objektpfad zu einer angegebenen instance zu erstellen.
GetObject	Ruft einen instance einer Klasse ab. Wird von WMI aufgerufen.
GetProviderName	Ruft den Namen des Anbieters ab.
MakeLocalPath	Erstellt einen vollständigen instance Pfad aus einem relativen Pfad.
PutInstance	Updates eine instance. Wird von WMI aufgerufen.
SetCreationClassName	Legt die CreationClassName-Zeichenfolgeneigenschaft des angegebenen instance auf den Namen dieses Anbieters fest.
ValidateDeletionFlags	Bestimmt, ob eine Gruppe von Flags für einen Löschvorgang gültig ist.
ValidateEnumerationFlags	Bestimmt, ob eine Gruppe von Flags für eine Enumeration gültig ist.
ValidateFlags	Bestimmt, ob eine Reihe von Flags gültig ist.
ValidateGetObjFlags	Bestimmt, ob eine Gruppe von Flags für einen instance Abrufvorgang gültig ist.
ValidateMethodFlags	Bestimmt, ob eine Gruppe von Flags für einen Ausführungsmethodevorgang gültig ist.
ValidatePutInstanceFlags	Bestimmt, ob eine Gruppe von Flags für einen instance Updatevorgang gültig ist.
ValidateQueryFlags	Bestimmt, ob eine Gruppe von Flags für einen Abfragevorgang gültig ist.

Vererbung

Die Provider-Klasse implementiert CThreadBase.

Methoden

Die Provider-Klasse verfügt über diese Methoden.

Anbieter::~Anbieter Die Provider::~Provider-Funktion ist ein Destruktor für die Provider-Klasse.
Anbieter::Commit Die Commit-Methode wird verwendet, um eine instance an WMI zu senden. Diese Methode ist eine Hilfsfunktion und sollte nicht überschrieben werden.
Anbieter::CreateNewInstance Die CreateNewInstance-Methode weist ein neues CInstance-Objekt zu und gibt einen Zeiger darauf zurück.
Anbieter::D eleteInstance Die DeleteInstance-Methode wird von WMI aufgerufen, um eine instance zu löschen. (Überladung 2/2)
Anbieter::D eleteInstance Die DeleteInstance-Methode wird von WMI aufgerufen, um eine instance zu löschen. (Überladung 1/2)
Provider::EnumerateInstances Die EnumerateInstances-Methode wird von WMI aufgerufen, um alle Instanzen der Klasse eines Frameworkanbieters abzurufen.
Anbieter::ExecMethod Die ExecMethod-Methode wird von WMI aufgerufen, um eine Methode für eine Klasse oder instance aufzurufen. (Überladung 1/2)
Anbieter::ExecMethod Die ExecMethod-Methode wird von WMI aufgerufen, um eine Methode für eine Klasse oder instance aufzurufen. (Überladung 2/2)
Anbieter::ExecQuery Die ExecQuery-Methode wird von WMI aufgerufen, um eine WMI-Abfrage (WMI Query Language, WQL) zu verarbeiten.
Anbieter::Flush Die Flush-Methode wird vom Anbieterframework aufgerufen, um den gesamten nicht benötigten Arbeitsspeicher zu löschen, der vom Anbieter verwendet wird.
Anbieter::GetLocalComputerName Die GetLocalComputerName-Methode gibt einen konstanten Verweis auf den Computernamen im CHString-Format zurück.
Anbieter::GetLocalInstancePath Die GetLocalInstancePath-Methode versucht, einen vollständigen Objektpfad zu einem angegebenen instance zu erstellen. Diese Methode ist eine Hilfsfunktion und sollte nicht überschrieben werden.
Anbieter::GetNamespace Die GetNamespace-Methode gibt einen konstanten Verweis auf den Namespacenamen im CHString-Format zurück. Der zurückgegebene Name ist der zweite Parameter, der ursprünglich dem Anbieterkonstruktor zugewiesen wurde.
Anbieter::GetObject Die GetObject-Methode wird von WMI aufgerufen, um eine instance einer Klasse abzurufen. (Überladung 1/3)
Provider::GetObject Die GetObject-Methode wird von WMI aufgerufen, um eine instance einer Klasse abzurufen. (Überladung 2/3)
Provider::GetObject Die GetObject-Methode wird von WMI aufgerufen, um eine instance einer Klasse abzurufen. (Überladung 3/3)
Provider::GetProviderName Die GetProviderName-Methode ruft den Namen der Klasse ab, die im Konstruktor des Anbieters verwendet wird.
Provider::MakeLocalPath Die MakeLocalPath-Methode erstellt einen vollständigen instance Pfad aus einem relativen Pfad.
Anbieter::P rovider Die Provider-Methode erstellt eine instance eines Anbieters. Diese Methode ist Teil des WMI-Anbieterframeworks.
Provider::P utInstance Die PutInstance-Methode aktualisiert eine instance. (Überladung 2/2)
Provider::P utInstance Die PutInstance-Methode aktualisiert eine instance. (Überladung 1/2)
Provider::SetCreationClassName Die SetCreationClassName-Methode legt ggf. die CreationClassName-Zeichenfolgeneigenschaft des angegebenen instance auf den Namen dieses Anbieters fest.
Provider::ValidateDeletionFlags Die ValidateDeletionFlags-Methode bestimmt, ob ein Satz von Flags für einen Löschvorgang gültig ist.
Provider::ValidateEnumerationFlags Die ValidateEnumerationFlags-Methode bestimmt, ob ein Satz von Flags für eine Enumeration gültig ist.
Provider::ValidateFlags Die ValidateFlags-Methode bestimmt, ob ein Satz von Flags gültig ist.
Provider::ValidateGetObjFlags Die ValidateGetObjFlags-Methode bestimmt, ob ein Satz von Flags für einen instance Abrufvorgang gültig ist.
Provider::ValidateMethodFlags Die ValidateMethodFlags-Methode bestimmt, ob ein Satz von Flags für einen Execute-Methodenvorgang gültig ist.
Provider::ValidatePutInstanceFlags Die ValidatePutInstanceFlags-Methode bestimmt, ob ein Satz von Flags für einen instance Updatevorgang gültig ist.
Provider::ValidateQueryFlags Die ValidateQueryFlags-Methode bestimmt, ob ein Satz von Flags für einen Abfragevorgang gültig ist.

Hinweise

Der Destruktor für diese Klasse ist Provider::~Provider.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	provider.h (schließen Sie FwCommon.h ein)