SWbemObject.CompareTo_ 方法

SWbemObject 对象的 CompareTo_ 方法比较两个 SWbemObject 对象。 此比较受某些限制的约束，这些限制基于 iFlags 参数中指定的值。

有关此语法的说明，请参阅脚本 API 的文档约定。

语法

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

parameters

objwbemObject [输入参数]

必需。 此参数是一个 SWbemObject 对象。 这是与第一个对象进行比较的对象。 对象必须是有效的 SWbemObject 实例。

iFlags [输入参数，可选]

指定将一个对象与其他对象进行比较时要考虑的对象特征。 可以使用 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