SWbemObject.CompareTo_ メソッド

SWbemObject オブジェクトの CompareTo_ メソッドは、2 つの 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
Header	Wbemdisp.h
タイプ ライブラリ	Wbemdisp.tlb
[DLL]	Wbemdisp.dll
CLSID	CLSID_SWbemObject
IID	IID_ISWbemObject

関連項目

SWbemObject