SWbemObject.CompareTo_ 方法

SWbemObject物件的CompareTo_方法會比較兩個SWbemObject物件。 這項比較會根據 iFlags 參數中指定的值，受限於特定條件約束。

如需此語法的說明，請參閱 腳本 API 的檔慣例。

語法

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

參數

objwbemObject [in]

必要。 此參數是 SWbemObject 物件。 這是比較第一個物件的物件。 物件必須是有效的 SWbemObject 實例。

iFlags [in， optional]

指定比較物件與其他物件時要考慮的物件特性。 您可以使用 wbemComparisonFlagIncludeAll 來考慮所有功能， (這是預設) 或下列值的任何組合。

wbemComparisonFlagIncludeAll (0 (0x0) )

比較所有屬性、限定詞和類別。

wbemComparisonFlagIgnoreObjectSource (2 (0x2) )

相較于其他物件，會導致物件的來源，也就是伺服器及其來源的命名空間。

wbemComparisonFlagIgnoreQualifiers (1 (0x1) )

使所有限定詞 (包括 索引鍵 和 動態) 在比較時被忽略。

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