Поделиться через

Применение квалификатора

  • Статья

Как и многие другие методы в формате управляемых объектов (MOF), применение квалификатора к коду является относительно простым процессом.

Единственными реальными проблемами являются следующие ограничения в соглашениях об именовании, которые применяет WMI:

  • Квалификатор может описать класс, экземпляр, свойство, метод или параметр метода.

  • Имена квалификатора не могут иметь начальные или конечные знаки подчеркивания.

  • Имя квалификатора не может начинаться с цифры.

  • Имя квалификатора не может содержать специальные символы, такие как & * @ ! ~ \ /.

  • Все имена квалификатора являются нечувствительными к регистру.

  • Нельзя переопределить стандартные квалификаторы WMI или любые квалификаторы, описанные в спецификации DMTF CIM.

  • Типы квалификатора не объявляются явно.

    Если тип квалификатора не объявлен, WMI предполагает тип как логический с значением TRUE. В противном случае квалификаторы типов WMI основаны на объявленных значениях квалификатора.

  • При создании собственных квалификаторов необходимо префиксировать имя схемы в имя квалификатора.

    Цель этого правила заключается в том, чтобы избежать путаницы с новыми квалификаторами.

  • Можно создать однородные массивы квалификаторов.

    В следующем примере кода показано, как массивы квалификатора указываются с фигурными скобками, окружающими значения.

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

  • WMI не поддерживает типы автоматизации, не перечисленные в справочнике, например VT_NULL. Дополнительные сведения см. в разделе "Типы данных MOF".

Следующая процедура помогает использовать C++ для добавления квалификатора в свойство.

Применение квалификатора с помощью C++

  • Примените квалификатор с вызовом метода IWbemQualifierSet::P ut .

    Вы можете использовать другие методы IWbemQualifierSet для извлечения или удаления существующих квалификаторов.

Следующая процедура помогает применить квалификатор в MOF-файлах.

Описание ключевое слово или идентификатора с квалификатором с помощью MOF

  • Поместите квалификатор в скобки перед ключевое слово или идентификатором, описанным квалификатором.

    В следующем примере кода показано, как используются квалификаторы.

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

    В следующем примере описывается правильное размещение квалификаторов.

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