Interface IWbemObjectAccess (wbemcli.h)

Article
03/03/2024

L’interface IWbemObjectAccess permet d’accéder aux méthodes et aux propriétés d’un objet. Un objet IWbemObjectAccess est un conteneur pour un instance mis à jour par un actualiseur. Avec l’interface IWbemObjectAccess , vous pouvez obtenir et définir des propriétés à l’aide de descripteurs de propriétés au lieu de noms de propriétés d’objet.

Note Cette interface n’est implémentée par les applications clientes ou les fournisseurs en aucun cas. L’implémentation fournie par WMI est la seule qui est prise en charge. Vous pouvez récupérer un pointeur vers l’interface en appelant IWbemClassObject ::QueryInterface.

Héritage

L’interface IWbemObjectAccess hérite de l’interface IUnknown. IWbemObjectAccess a également les types de membres suivants :

Méthodes

L’interface IWbemObjectAccess utilise ces méthodes.


IWbemObjectAccess ::GetPropertyHandle La méthode GetPropertyHandle retourne un handle unique qui identifie une propriété. Vous pouvez utiliser ce descripteur pour identifier les propriétés lors de l’utilisation des méthodes IWbemObjectAccess pour lire ou écrire des valeurs de propriété.
IWbemObjectAccess ::GetPropertyInfoByHandle La méthode GetPropertyInfoByHandle retourne le nom et le type de données de la propriété associée à un handle de propriété.
IWbemObjectAccess ::Lock La méthode Lock empêche d’autres threads de mettre à jour un objet IWbemObjectAccess jusqu’à ce qu’il soit déverrouillé.
IWbemObjectAccess ::ReadDWORD La méthode ReadDWORD lit 32 bits de données de propriété à l’aide d’un handle de propriété.
IWbemObjectAccess ::ReadPropertyValue La méthode ReadPropertyValue retourne un nombre spécifié d’octets d’une propriété associée à un handle de propriété.
IWbemObjectAccess ::ReadQWORD La méthode ReadQWORD lit 64 bits de données de propriété identifiées par un handle de propriété.
IWbemObjectAccess ::Unlock La méthode Unlock permet à d’autres threads de mettre à jour les valeurs de propriété d’un objet IWbemObjectAccess.
IWbemObjectAccess ::WriteDWORD La méthode WriteDWORD écrit 32 bits de données dans une propriété identifiée par un handle de propriété.
IWbemObjectAccess ::WritePropertyValue La méthode WritePropertyValue écrit un nombre spécifié d’octets dans une propriété identifiée par un handle de propriété. Utilisez cette méthode pour définir la chaîne et toutes les autres données non-DWORD ou non-QWORD.
IWbemObjectAccess ::WriteQWORD La méthode WriteQWORD écrit 64 bits de données dans une propriété à l’aide d’un handle de propriété.

Remarques

Les méthodes IWbemObjectAccess qui lisent et écrivent des données effectuent très peu de validation des données. Étant donné que les méthodes IWbemObjectAccess accèdent directement aux propriétés, vous pouvez obtenir et définir des propriétés beaucoup plus rapidement que les techniques d’accès aux objets standard telles que IWbemClassObject ::Get et IWbemClassObject ::P ut.

Note Pour optimiser sa vitesse, IWbemObjectAccess est complètement décoché. Il incombe à l’utilisateur de s’assurer que tous les handles sont corrects et que les mémoires tampons d’écriture sont correctement dimensionnées. Les opérations de lecture et d’écriture ne sont pas intrinsèquement thread-safe. Vous devez appeler les méthodes IWbemObjectAccess ::Lock et IWbemObjectAccess ::Unlock pour empêcher les objets IWbemObjectAccess d’accéder simultanément sur plusieurs threads.

Les handles de propriété sont les mêmes pour toutes les instances d’une classe. Par conséquent, il n’est nécessaire de récupérer un handle qu’une seule fois.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	wbemcli.h (include Wbemidl.h)

Voir aussi

Accès aux données de performances en C++

Accès aux classes de performances préinstallées WMI

API COM pour WMI

IWbemRefresher

Partager via