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