Partager via

Application d’un qualificateur

  • Article

Comme beaucoup d’autres techniques avec le format MOF (Managed Object Format), appliquer un qualificateur au code est un processus relativement simple.

Les seules difficultés concernent les restrictions suivantes dans les conventions de nommage appliquées par WMI :

  • Un qualificateur peut décrire une classe, une instance, une propriété, une méthode ou un paramètre de méthode.

  • Les noms de qualificateurs ne peuvent pas commencer ni finir par des traits de soulignement.

  • Un nom de qualificateur ne peut pas commencer par un chiffre.

  • Un nom de qualificateur ne peut pas contenir de caractères spéciaux comme & * @ ! ~ \ /.

  • Les noms de qualificateurs ne respectent pas la casse.

  • Vous ne pouvez pas redéfinir les qualificateurs WMI standard ou les qualificateurs décrits dans la spécification CIM DMTF.

  • Les types de qualificateurs ne sont pas déclarés explicitement.

    Si vous ne déclarez pas de type de qualificateur, WMI suppose que le type est Boolean avec la valeur TRUE. Sinon, WMI définit le type des qualificateurs d’après les valeurs de qualificateur que vous déclarez.

  • Lorsque vous créez vos propres qualificateurs, vous devez faire précéder le nom du qualificateur du nom de votre schéma.

    Cette règle vise à éviter toute confusion avec de nouveaux qualificateurs.

  • Vous pouvez créer des tableaux homogènes de qualificateurs.

    L’exemple de code suivant montre comment spécifier les tableaux de qualificateurs en mettant les valeurs entre accolades.

    [StringArray{"hello", "there"}, SingleElementArray{3}]

  • WMI ne prend pas en charge les types automation qui ne sont pas listés dans les informations de référence, tels que VT_NULL. Pour plus d’informations, consultez Types de données MOF.

La procédure suivante vous explique comment utiliser C++ pour ajouter un qualificateur à une propriété.

Pour appliquer un qualificateur en utilisant C++

  • Appliquez le qualificateur avec un appel à la méthode IWbemQualifierSet::P ut.

    Vous pouvez utiliser d’autres méthodes de IWbemQualifierSet pour récupérer ou supprimer des qualificateurs existants.

La procédure suivante vous montre comment appliquer un qualificateur dans des fichiers MOF.

Pour décrire un mot clé ou un identificateur avec un qualificateur au format MOF

  • Placez un qualificateur entre crochets avant le mot clé ou l’identificateur décrit par le qualificateur.

    L’exemple de code suivant montre comment utiliser les qualificateurs.

    [qualifiers...]
class StdDisk
{
  [qualifiers...]  uint32 dwNumCylinders;
  [qualifiers...]  uint32 dwNumHeads;
  [qualifiers...]  sint32 Method1();
  sint32 Method2([qualifiers...] Parameter1);
};

    L’exemple suivant décrit le placement approprié des qualificateurs.

    [Abstract]
class MyClass
{
    [Amendment, InstanceOf]  uint32 dwNumber;
    sint32 MyMethod ([in] sint32 Param);
};