метод SWbemObject.CompareTo_

Статья
06/13/2023

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

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

Синтаксис

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

Параметры

objwbemObject [in]: Обязательный. Этот параметр является объектом SWbemObject . Это объект, с которым сравнивается первый объект. Объект должен быть допустимым экземпляром SWbemObject .
iFlags [in, необязательный]: Указывает характеристики объекта, которые следует учитывать при сравнении объекта с другими объектами. Вы можете использовать wbemComparisonFlagIncludeAll для рассмотрения всех функций (это значение по умолчанию) или любое сочетание следующих значений.
wbemComparisonFlagIncludeAll (0 (0x0)): Сравнивает все свойства, квалификаторы и вкусы.
wbemComparisonFlagIgnoreObjectSource (2 (0x2)): Заставляет игнорировать источник объектов, а именно сервер и пространство имен, из чего они пришли, по сравнению с другими объектами.
wbemComparisonFlagIgnoreQualifiers (1 (0x1)): Приводит к тому, что все квалификаторы (включая Key и Dynamic) игнорируются при сравнении.
wbemComparisonFlagIgnoreDefaultValues (4 (0x4)): Приводит к игнорированию значений свойств по умолчанию. Этот флаг имеет смысл только при сравнении классов.
wbemComparisonFlagIgnoreFlavor (32 (0x20)): Вызывает игнорирование вкусов квалификатора. Этот флаг учитывает значения квалификатора, но игнорирует различия вкуса, такие как правила распространения и ограничения переопределения.
wbemComparisonFlagIgnoreCase (16 (0x10)): Сравнивает строковые значения без учета регистра. Это относится как к строкам, так и к значениям квалификатора. Имена свойств и квалификаторов всегда сравниваются без учета регистра, независимо от того, установлен данный флаг или нет.
wbemComparisonFlagIgnoreClass (8 (0x8)): Указывает системе, что сравниваемые объекты являются экземплярами одного класса. Следовательно, этот флаг сравнивает только сведения, связанные с экземпляром. Этот флаг позволяет оптимизировать производительность. Если объекты не являются экземплярами одного класса, результаты будут неопределенными.

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

Этот метод возвращает логическое значение 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_SWbemObject
IID	IID_ISWbemObject

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

SWbemObject

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