IWbemContext-Schnittstelle (wbemcli.h)
Die IWbemContext-Schnittstelle wird optional verwendet, um anbieter beim Übermitteln von IWbemServices-Aufrufen an WMI zusätzliche Kontextinformationen zu kommunizieren. Alle primären Aufrufe in IWbemServices verwenden einen optionalen Parameter, der auf ein Objekt dieses Typs zeigt.
Vererbung
Die IWbemContext-Schnittstelle erbt von der IUnknown-Schnittstelle . IWbemContext verfügt auch über folgende Membertypen:
Methoden
Die IWbemContext-Schnittstelle verfügt über diese Methoden.
| IWbemContext::BeginEnumeration Die IWbemContext::BeginEnumeration-Methode setzt die Enumeration aller Kontextwerte im -Objekt zurück. |
| IWbemContext::Clone Die IWbemContext::Clone-Methode stellt eine logische Kopie des aktuellen IWbemContext-Objekts her. Diese Methode kann nützlich sein, wenn viele Aufrufe erfolgen müssen, die weitgehend identische IWbemContext-Objekte aufweisen. |
| IWbemContext::D eleteAll Die IWbemContext::D eleteAll-Methode entfernt alle benannten Kontextwerte aus dem aktuellen Objekt, wodurch das Objekt geleert wird. |
| IWbemContext::D eleteValue Die IWbemContext::D eleteValue-Methode löscht einen benannten Kontextwert, der von IWbemContext::SetValue erstellt wurde. |
| IWbemContext::EndEnumeration Die IWbemContext::EndEnumeration-Methode beendet eine Enumerationssequenz, die mit IWbemContext::BeginEnumeration beginnt. Dieser Aufruf ist nicht erforderlich, gibt aber alle systemressourcen, die der Enumeration zugeordnet sind, so früh wie möglich frei. |
| IWbemContext::GetNames Die IWbemContext::GetNames-Methode gibt eine SAFEARRAY-Struktur aller Namen der benannten Kontextwerte zurück. |
| IWbemContext::GetValue Die IWbemContext::GetValue-Methode wird verwendet, um einen bestimmten benannten Kontextwert anhand des Namens abzurufen. |
| IWbemContext::Next Die IWbemContext::Next-Methode ruft den nächsten Wert in einer Enumeration aller Kontextwerte ab, die mit IWbemContext::BeginEnumeration beginnen. |
| IWbemContext::SetValue Die IWbemContext::SetValue-Methode erstellt oder überschreibt einen benannten Kontextwert. |
Hinweise
Häufig erfordern dynamische Anbieter mehr Informationen, als in den normalen Parametern einer IWbemServices-Methode angegeben ist. Um z. B. WMI-Schemaobjekte zu bearbeiten, die er bereitstellt, muss ein Anbieter möglicherweise einen SNMP-Communitynamen (Simple Network Management Protocol) oder einen sql-Datenbank- und Tabellennamen (strukturierte Abfragesprache) kennen. Ein Client kann diese Informationen einem IWbemContext-Objekt hinzufügen und das IWbemContext-Objekt zusammen mit dem Aufruf als einen der Parameter senden.
Anbieter sollten Inhaltsobjekte sparsam verwenden. Es wird empfohlen, dass dies niemals erforderlich ist. Wenn ein Anbieter eine große Menge an hochspezifischen Kontextinformationen benötigt, um auf eine Anforderung zu reagieren, müssen alle Clients codiert werden, um diese Informationen bereitzustellen, wodurch das einheitliche Zugriffsmodell, das die Grundlage von WMI ist, unterbricht. In manchen Fällen ist dies jedoch nicht zu vermeiden. Daher wird dieser Mechanismus bereitgestellt, um den Zugriff auf solche Anbieter zu ermöglichen. Entwickler solcher Anbieter sollten eine angemessene Dokumentation bereitstellen, damit Entwickler von Clientsoftware solche CIM-Objekte erfolgreich bearbeiten können.
Anbieter, die die Verwendung von IWbemContext unterstützen, damit Clients weitere Informationen in einer Anforderung angeben können, sollten die unterstützten Wertetypen auf die Typen in der folgenden Liste beschränken:
- VT_I4
- VT_R8
- VT_BOOL
- VT_BSTR
- VT_UNKNOWN
- Alle oben genannten Optionen in Kombination mit VT_ARRAY
Die in einem IWbemContext-Objekt enthaltenen Informationen werden vollständig vom zugrunde liegenden Anbieter bestimmt. WMI verwendet die Informationen nicht, sondern leitet sie an den Anbieter weiter. Anbieter müssen die Kontextinformationen veröffentlichen, die sie für diese Dienstanforderungen benötigen.
Die Clientanwendung ruft CoCreateInstanceEx auf, um ein einzelnes Kontextobjekt zu erstellen. Anschließend wird SetValue einmal oder mehrmals aufgerufen, um Kontextwerte für den Anbieter einzurichten. Schließlich wird das -Objekt an eine der IWbemServices-Methoden übermittelt, die sofort Release für das Kontextobjekt aufruft, nachdem der Aufruf zurückgegeben wurde. Die anderen Methoden werden in erster Linie von Anbietern verwendet, die das Kontextobjekt empfangen und Informationen extrahieren müssen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | wbemcli.h (include Wbemidl.h) |
Weitere Informationen
Erstellen und Deklarieren einer Instanz mit C++