Метод SWbemLastError.CompareTo_

  • Статья

Метод CompareTo_ объекта SWbemLastError сравнивает два объекта SWbemObject . Это сравнение подвержено определенным ограничениям на основе значений, указанных в параметре iFlags .

Описание этого синтаксиса см. в разделе Соглашения о документах для API сценариев.

Синтаксис

bAreEqual = .CompareTo_( _
  ByVal objwbemObject, _
  [ ByVal iFlags ] _
)

Параметры

objwbemObject [in]

Обязательный. Объект класса SWbemObject . Этот параметр является объектом, с которым сравнивается первый объект. Объект должен быть допустимым экземпляром SWbemObject .

iFlags [in, необязательный]

Целое число, указывающее дополнительные флаги операции. Этот параметр задает характеристики объекта, которые следует учитывать при сравнении объектов. Вы можете использовать wbemComparisonFlagIncludeAll для рассмотрения всех функций (по умолчанию) или любого сочетания следующих значений.

wbemComparisonFlagIncludeAll (0 (0x0))

Вызывает сравнение всех свойств, квалификаторов и вкусов.

wbemComparisonFlagIgnoreQualifiers (1 (0x1))

Приводит к тому, что все квалификаторы (включая Key и Dynamic) игнорируются при сравнении.

wbemComparisonFlagIgnoreObjectSource (2 (0x2))

Заставляет игнорировать источник объектов, а именно сервер и пространство имен, из чего они пришли, по сравнению с другими объектами.

wbemComparisonFlagIgnoreDefaultValues (4 (0x4))

Вызывает игнорирование значений свойств по умолчанию. Этот флаг имеет смысл только при сравнении классов.

wbemComparisonFlagIgnoreClass (8 (0x8))

Указывает системе, что сравниваемые объекты являются экземплярами одного класса. Следовательно, этот флаг сравнивает только сведения, связанные с экземпляром. Этот флаг позволяет оптимизировать производительность. Если объекты не являются экземплярами одного класса, результаты будут неопределенными.

wbemComparisonFlagIgnoreCase (16 (0x10))

Вызывает сравнение строковых значений без учета регистра. Это относится как к строкам, так и к значениям квалификатора. Имена свойств и квалификаторов всегда сравниваются без учета регистра, независимо от того, установлен данный флаг или нет.

wbemComparisonFlagIgnoreFlavor (32 (0x20))

Вызывает игнорирование вкусов квалификатора. Этот флаг позволяет учитывать значения квалификаторов, но при этом игнорируются такие свойства флага, как правила распространения и ограничения на перезапись.

Возвращаемое значение

Метод CompareTo_ возвращает логическое значение TRUE , если объекты совпадают; В противном случае возвращается значение FALSE.

Коды ошибок

После завершения метода CompareTo_ объект Err может содержать один из кодов ошибок в следующем списке.

wbemErrFailed — 2147749889 (0x80041001)

Незаданная ошибка.

wbemErrInvalidParameter — 2147749896 (0x80041008)

Указанный параметр недопустим.

wbemErrOutOfMemory — 2147749894 (0x80041006)

Недостаточно памяти для завершения операции.

Требования

Требование Значение
Минимальная версия клиента
 Windows Vista
Минимальная версия сервера
 Windows Server 2008
Заголовок
Wbemdisp.h
Библиотека типов
Wbemdisp.tlb
DLL
Wbemdisp.dll
CLSID
 CLSID_SWbemLastError
IID
 IID_ISWbemLastError

См. также раздел

SWbemLastError

SWbemObject