Anwenden eines Qualifizierers

Wie viele andere Techniken im Managed Object Format (MOF) ist das Anwenden eines Qualifizierers auf Ihren Code ein relativ einfacher Prozess.

Die einzigen wirklichen Herausforderungen sind die folgenden Einschränkungen bei Benennungskonventionen, die von WMI erzwungen werden:

• Ein Qualifizierer kann eine Klasse, eine Instanz, eine Eigenschaft, eine Methode oder einen Methodenparameter beschreiben.

• Qualifizierernamen dürfen weder mit einem Unterstrich beginnen noch mit einem Unterstrich enden.

• Ein Qualifizierername darf nicht mit einer Ziffer beginnen.

• Ein Qualifizierername darf keine Sonderzeichen wie die folgenden enthalten: & * @ ! ~ \ /.

• Bei Qualifizierernamen wird die Groß-/Kleinschreibung nicht beachtet.

• Weder die standardmäßigen WMI-Qualifizierer noch die in der DMTF-CIM-Spezifikation beschriebenen Qualifizierer dürfen neu definiert werden.

• Qualifizierertypen sind nicht explizit deklariert.

  Wenn Sie keinen Qualifizierertyp deklarieren, geht WMI von einem booleschen Typ mit dem Wert TRUE aus. Andernfalls werden Qualifizierer von WMI basierend auf den von Ihnen deklarierten Qualifiziererwerten typisiert.

• Wenn Sie Ihre eigenen Qualifizierer erstellen, sollten Sie Ihren Qualifizierernamen den Namen Ihres Schemas als Präfix voranstellen.

  Dies dient dazu, Verwechslungen mit neuen Qualifizierern zu vermeiden.

• Sie können homogene Arrays von Qualifizierern erstellen.

  Das folgende Codebeispiel zeigt, wie Qualifiziererarrays mit geschweiften Klammern angegeben werden, die die Werte umschließen:

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

• WMI unterstützt keine Automatisierungstypen, die nicht in der Referenz aufgeführt sind (beispielsweise VT_NULL). Weitere Informationen finden Sie unter MOF-Datentypen.

Das folgende Verfahren hilft Ihnen dabei, einer Eigenschaft einen Qualifizierer mithilfe von C++ zu hinzuzufügen.

So wenden Sie einen Qualifizierer mithilfe von C++ an

• Wenden Sie den Qualifizierer mit einem Aufruf der IWbemQualifierSet::Put-Methode an.

  Sie können andere Methoden von IWbemQualifierSet verwenden, um vorhandene Qualifizierer abzurufen oder zu löschen.

Das folgende Verfahren hilft Ihnen beim Anwenden eines Qualifizierers in MOF-Dateien.

So beschreiben Sie ein Schlüsselwort oder einen Bezeichner mit einem Qualifizierer unter Verwendung von MOF

• Platzieren Sie einen Qualifizierer in Klammern vor dem vom Qualifizierer beschriebenen Schlüsselwort oder Bezeichner.

  Im folgenden Codebeispiel wird die Verwendung von Qualifizierern veranschaulicht:

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

  Im folgenden Beispiel wird die richtige Platzierung von Qualifizierern beschrieben:

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