FAQ DelphiConsultez toutes les FAQ

Utiliser WMI permet de s'affranchir de la connaissance de l'API Windows au prix d'un apprentissage minimum sur les principes de base. WMI est surtout utilisé pour automatiser des tâches d'administration avec VBScript.

Windows Management Instrumentation (WMI) est basé sur la technologie COM, l'accès et la manipulation de WMI se font par l'intermédiaire des objets de scripting SWbemxxxx qui encapsulent les appels COM et par certaines interfaces IWbemxxxx.

Web-Based Enterprise Management (WBEM) est une initiative de différents constructeurs afin de développer des moyens normalisés et non-propriétaires permettant d'accéder et de partager l'information liée à l'infrastructure (matériel et logiciel) d'un réseau d'entreprise.

Avant d'aller plus loin il vous faut savoir que les plateformes NT et Windows 9x ne supportent pas en natif cette technologie. Dans ce cas il vous faudra déployer WMI pour que votre application l'utilisant fonctionne.

À noter :
Quelques classes WMI et/ou méthodes ne sont pas implémentées sur toutes les plateformes. Consultez laMSDN pour le détail des classes que vous utilisez.
Les accès à WMI se font différemment sous Delphi .NET.

WMI gère une base de données (référentiel) sur chaque PC sur lequel il est installé. Le service nommé Infrastructure de gestion Windows doit être démarré.
Le répertoire C:\WINDOWS\system32\wbem\ contient les DLL et outils mis à notre disposition.
Le référentiel se situe dans le répertoire C:\WINDOWS\system32\wbem\Repository\FS.
Attention, on n'accède pas directement à ce référentiel.

Pour accéder à WMI sous Delphi on doit importer la librairie de type nommée Microsoft WMI Scripting v1.1 Library (Version 1.1), située dans C:\WINDOWS\system32\wbem\wbemdisp.tlb.
Cette librairie nous propose les composants suivants :

• TSWbemLocator
• TSWbemNamedValueSet
• TSWbemObjectPath
• TSWbemLastError
• TSWbemSink
• TSWbemDateTime
• TSWbemRefresher
  

Vous trouverez de nombreuses informations sur WMI dans ce tutoriel : Windows Management Instrumentation (WMI), première partie.
Cette section de la FAQ reprend sous une autre forme et en plus détaillé le contenu du
tutoriel Windows Management Instrumentation (WMI), seconde partie.

Vous trouverez dans la première partie du tutoriel sur WMI de nombreux liens complémentaires ainsi que des sources d'exemples.
Dans le second vous trouverez de nombreux programmes d'exemple.

Le site le plus fourni étant bien évidemment MSDN : WMI Start Page.

Vous trouverez dans le document suivant intitulé Comment lire un kit SDK ?), des explications sur la manière de décrypter le code des kits SDK (Software Development Kits) et des références de langage.

L'unité WbemCli.pas est la translation de header WbemCli.h contenant entre autres les constantes d'erreur WMI.

L'unité WMITools.pas contient de nombreuses méthodes qui faciliteront vos premiers programmes d'accés au
données WMI.

Enfin pour les possesseurs de BDS l'unité UIterateurEnumVariant facilitera les itérations de collections sur 2 ou 3 niveaux.
Exemple :

1
2
3
4
5
6
7
8
9
10
11
... 
For MonObjetWMI in ObjectEnumerator do 
  begin 
      // Utilise la collection de propriétés d'un objet WMI pour créer un second itérateur distinct. 
   PropertyEnumerator:= TEnumVariant.Create((MonObjetWMI as SWBemObject).Properties_); 
  
   For MaProprieteWMI in PropertyEnumerator do 
   begin 
      // Retrouve certains détails d'un point de restauration via les propriétés de classe WMI. 
    With (MaProprieteWMI as SWBemProperty)  do 
...