SWbemObject.CompareTo_方法

SWbemObject 对象的CompareTo_方法比较两个 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) )

将所有限定符 ((包括 KeyDynamic) )进行比较时将被忽略。

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