Partager via


Qualificateur de clé

Le qualificateur de clé indique si la propriété fait partie du descripteur d’espace de noms. Si plusieurs propriétés ont le qualificateur de clé, toutes ces propriétés forment collectivement la clé (une clé composée). Lorsqu’elles sont regroupées, les propriétés de clé doivent fournir une référence unique pour chaque instance de classe. Si ce qualificateur est placé sur une propriété, seule la valeur TRUE est autorisée.

Vous pouvez utiliser n’importe quel type de propriété à l’exception des éléments suivants :

  • Tableaux
  • Nombres réels et à virgule flottante
  • Objets incorporés
  • Caractères inférieurs à ASCII 32 (c’est-à-dire des espaces blancs)
  • Les chaînes de caractères de type char16 ou les chaînes de caractères définies en tant que clés doivent contenir des valeurs supérieures à U+0020. Cela est dû au fait que WMI utilise des valeurs de clé dans les chemins d’accès aux objets et que vous ne pouvez pas utiliser de caractères non imprimables dans un chemin d’accès d’objet.

Lorsqu’une classe parente spécifie une clé, toutes les classes dérivées de la classe parent héritent de cette clé. Les classes dérivées ne peuvent pas modifier la clé héritée ou définir une nouvelle propriété de clé. Toutefois, lorsque vous dérivez une sous-classe d’une classe abstraite sans clé, vous pouvez introduire une clé dans la sous-classe.

Toutes les classes qui définissent plusieurs instances doivent spécifier une clé. Étant donné que les classes abstraites ne définissent aucune instance, elles n’ont pas besoin de spécifier des clés. Étant donné que les classes singleton ne définissent qu’une seule instance, elles ne peuvent pas spécifier de clés.

Les clés sont écrites une fois lors de l’instanciation de l’objet et ne doivent pas être modifiées ultérieurement. Il n’est pas judicieux d’appliquer une valeur par défaut à une propriété qualifiée de clé.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows Vista
Serveur minimal pris en charge
Windows Server 2008