Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.
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++