IWbemObjectAccess-Schnittstelle (wbemcli.h)

Die IWbemObjectAccess-Schnittstelle ermöglicht den Zugriff auf die Methoden und Eigenschaften eines Objekts. Ein IWbemObjectAccess-Objekt ist ein Container für eine Instanz, die von einer Aktualisierung aktualisiert wird. Mit der IWbemObjectAccess-Schnittstelle können Sie Eigenschaften abrufen und festlegen, indem Sie Eigenschaftenhandles anstelle von Objekteigenschaftennamen verwenden.

Hinweis Diese Schnittstelle wird unter keinen Umständen von Clientanwendungen oder -anbietern implementiert. Die von WMI bereitgestellte Implementierung ist die einzige, die unterstützt wird. Ein Zeiger auf die Schnittstelle kann abgerufen werden, indem Sie IWbemClassObject::QueryInterface aufrufen.

 

Vererbung

Die IWbemObjectAccess-Schnittstelle erbt von der IUnknown-Schnittstelle . IWbemObjectAccess verfügt auch über die folgenden Typen von Membern:

Methoden

Die IWbemObjectAccess-Schnittstelle verfügt über diese Methoden.

IWbemObjectAccess::GetPropertyHandle Die GetPropertyHandle-Methode gibt ein eindeutiges Handle zurück, das eine Eigenschaft identifiziert. Sie können diesen Handle verwenden, um Eigenschaften zu identifizieren, wenn IWbemObjectAccess-Methoden zum Lesen oder Schreiben von Eigenschaftswerten verwendet werden.
IWbemObjectAccess::GetPropertyInfoByHandle Die GetPropertyInfoByHandle-Methode gibt den Namen und datentyp der Eigenschaft zurück, die einem Eigenschaftenhandle zugeordnet ist.
IWbemObjectAccess::Lock Die Lock-Methode verhindert, dass andere Threads ein IWbemObjectAccess-Objekt aktualisieren, bis es entsperrt wird.
IWbemObjectAccess::ReadDWORD Die ReadDWORD-Methode liest 32 Bits von Eigenschaftendaten mithilfe eines Eigenschaftenhandles.
IWbemObjectAccess::ReadPropertyValue Die ReadPropertyValue-Methode gibt eine angegebene Anzahl von Bytes einer Eigenschaft zurück, die einem Eigenschaftenhandle zugeordnet ist.
IWbemObjectAccess::ReadQWORD Die ReadQWORD-Methode liest 64 Bits von Eigenschaftendaten, die durch ein Eigenschaftenhandle identifiziert werden.
IWbemObjectAccess::Unlock Mit der Unlock-Methode können andere Threads die Eigenschaftswerte eines IWbemObjectAccess-Objekts aktualisieren.
IWbemObjectAccess::WriteDWORD Die WriteDWORD-Methode schreibt 32 Bits an Daten in eine Eigenschaft, die durch ein Eigenschaftenhandle identifiziert wird.
IWbemObjectAccess::WritePropertyValue Die WritePropertyValue-Methode schreibt eine angegebene Anzahl von Bytes in eine Eigenschaft, die durch ein Eigenschaftenhandle identifiziert wird. Verwenden Sie diese Methode, um Zeichenfolge und alle anderen Nicht-DWORD- oder Nicht-QWORD-Daten festzulegen.
IWbemObjectAccess::WriteQWORD Die WriteQWORD-Methode schreibt mithilfe eines Eigenschaftenhandles 64 Bits an Daten in eine Eigenschaft.

Hinweise

Die IWbemObjectAccess-Methoden zum Lesen und Schreiben von Daten führen sehr wenig Datenüberprüfung durch. Da IWbemObjectAccess-Methoden direkt auf Eigenschaften zugreifen, können Sie Eigenschaften viel schneller abrufen und festlegen als standardobjektzugriffstechniken wie IWbemClassObject::Get und IWbemClassObject::P ut.

Hinweis Um die Geschwindigkeit zu maximieren, ist IWbemObjectAccess vollständig deaktiviert. Es liegt in der Verantwortung des Benutzers sicherzustellen, dass alle Handles ordnungsgemäß sind und dass Schreibpuffer richtig dimensioniert sind. Lese- und Schreibvorgänge sind nicht threadsicher. Sie sollten die Methoden IWbemObjectAccess::Lock und IWbemObjectAccess::Unlock aufrufen, um zu verhindern, dass IWbemObjectAccess-Objekte gleichzeitig auf mehrere Threads zugreifen.

 

Eigenschaftenhandles sind für alle Instanzen einer Klasse identisch. Daher muss ein Handle nur einmal abgerufen werden.

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

Zugreifen auf Leistungsdaten in C++

Zugreifen auf vorinstallierte WMI-Leistungsklassen

COM-API für WMI

IWbemRefresher