SWbemLastError.CompareTo_ メソッド

SWbemLastError オブジェクトの CompareTo_ メソッドは、2 つの SWbemObject オブジェクトを比較します。 この比較は、iFlags パラメータで指定された値に基づく特定の制約を受けます。

この構文の説明については、「スクリプト API のドキュメントの表記規則」を参照してください。

構文

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

パラメーター

objwbemObject [in]

必須。 SWbemObject クラス オブジェクト。 このパラメータは、最初のオブジェクトと比較するオブジェクトです。 オブジェクトは、有効な SWbemObject インスタンスである必要があります。

iFlags [in、オプション]

操作に追加のフラグを指定する整数。 このパラメータでは、オブジェクトの比較を行うときに考慮するオブジェクト特性を指定します。 wbemComparisonFlagIncludeAll を使用すると、すべての機能 (既定値) または次の値の任意の組み合わせを考慮できます。

wbemComparisonFlagIncludeAll (0 (0x0))

すべてのプロパティ、修飾子、およびフレーバーを比較します。

wbemComparisonFlagIgnoreQualifiers (1 (0x1))

比較で、すべての修飾子 (Key と Dynamic を含む) を無視します。

wbemComparisonFlagIgnoreObjectSource (2 (0x2))

他のオブジェクトとの比較で、オブジェクトのソース (それらの取得元のサーバーと名前空間) を無視します。

wbemComparisonFlagIgnoreDefaultValues (4 (0x4))

プロパティの既定値を無視します。 このフラグは、クラスの比較時にのみ有効です。

wbemComparisonFlagIgnoreClass (8 (0x8))

比較対象のオブジェクトが同じクラスのインスタンスであることを前提とするようにシステムに指示します。 結果として、このフラグを指定すると、インスタンス関連の情報のみが比較されます。 パフォーマンスを最適化するには、このフラグを使用します。 オブジェクトが同じクラスではない場合、結果は未定義になります。

wbemComparisonFlagIgnoreCase (16 (0x10))

大文字と小文字を区別しない方法で文字列値を比較します。 これは、文字列と修飾子値の両方に適用されます。 プロパティ名および修飾子名は、このフラグが指定されているかどうかにかかわらず、常に大文字と小文字を区別せずに比較されます。

wbemComparisonFlagIgnoreFlavor (32 (0x20))

修飾子のフレーバーを無視します。 このフラグは、修飾子の値を考慮に入れますが、反映規則やオーバーライド制限などのフレーバーの区別を無視します。

戻り値

CompareTo_ メソッドは、オブジェクトが一致する場合、ブール値 TRUE を返し、それ以外の場合、FALSE を返します。

エラー コード

CompareTo_ メソッドの完了時、Err オブジェクトに次の一覧のいずれかのエラー コードが含まれる場合があります。

wbemErrFailed - 2147749889 (0x80041001)

未定義のエラーが発生しました。

wbemErrInvalidParameter - 2147749896 (0x80041008)

指定されたパラメータが無効です。

wbemErrOutOfMemory - 2147749894 (0x80041006)

操作を完了させるための十分なメモリがありません。

要件

関連項目

SWbemLastError

SWbemObject