SWbemObject.References_ method

SWbemObject オブジェクトの References_ メソッドは、現在のオブジェクトを参照するすべての関連付けクラスまたはインスタンスのコレクションを返します。

このメソッドは、REFERENCES OF WQL クエリと同じ関数を実行します。

この構文の説明については、スクリプト API のドキュメント規則に関するページを参照してください。

構文

objWbemObjectSet = .References_( _
  [ ByVal strResultClass ], _
  [ ByVal strRole ], _
  [ ByVal bClassesOnly ], _
  [ ByVal bSchemaOnly ], _
  [ ByVal strRequiredQualifier ], _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ] _
)

パラメーター

strResultClass [in、省略可能]

クラス名を含む文字列。 指定した場合、このパラメータは、返される関連付けオブジェクトがこのパラメータで指定されたクラスに属しているか、そのクラスから派生していなければならないことを示します。

strRole [in、省略可能]

プロパティ名を含む文字列。 指定した場合、このパラメーターは、返される関連付けオブジェクトが、ソース オブジェクトが特定の役割を果たすオブジェクトに制限されていなければならないことを示します。 役割は、関連付けの指定されたプロパティ (参照プロパティである必要があります) の名前によって定義されます。

bClassesOnly [in、省略可能]

クラスの実際のインスタンスではなく、クラス名のリストを返す必要があるかどうかを示すブール値。 これらは、関連付けオブジェクトが属しているクラスです。 このパラメーターの既定値は、FALSE です。

bSchemaOnly [in、省略可能]

クエリはデータではなくスキーマに適用されるのかどうかを示すブール値。 このパラメーターの既定値は、FALSE です。 TRUE に設定できるのは、このメソッドが呼び出されるオブジェクトがクラスである場合のみです。 TRUE に設定すると、返されるエンドポイントのセットは、スキーマ内のソース クラスに適切に関連付けられているクラスを表します。

strRequiredQualifier [in、省略可能]

修飾子名を含む文字列。 指定した場合、このパラメータは、返される関連付けオブジェクトは指定された修飾子を含まなければならないことを示します。

iFlags [in、省略可能]

操作に対する追加のフラグを指定する整数。 このパラメーターの既定値は wbemFlagReturnImmediately であり、クエリが完了するまで待つのでなく、すぐに返されるよう呼び出しに指示します。 このパラメーターには次の値を指定することができます。

wbemFlagForwardOnly (32 (0x20))

順方向専用の列挙子を返します。 一般的に、順方向専用の列挙子は、従来の列挙子よりもずっと高速で、使用されるメモリが少なくなりますが、SWbemObject.Clone_ の呼び出しは許可されません。

wbemFlagBidirectional (0 (0x0))

クライアントが列挙子を解放するまで、Windows Management Instrumentation (WMI) が列挙のオブジェクトへのポインターを保持します。

wbemFlagReturnImmediately (16 (0x10))

呼び出しはすぐに戻ります。

wbemFlagReturnWhenComplete (0 (0x0))

クエリが完了するまで、この呼び出しをブロックします。

wbemFlagUseAmendedQualifiers (131072 (0x20000))

WMI が基底クラス定義を使用してクラス変更データを返します。 修正修飾子の詳細については、「WMI クラス情報のローカライズ」を参照してください。

objwbemNamedValueSet [in、省略可能]

通常、これは未定義です。 そうでない場合、これは SWbemNamedValueSet オブジェクトであり、その要素は、要求を処理しているプロバイダーが使用できるコンテキスト情報を表します。 このような情報をサポートする、または必要とするプロバイダーは、認識された値名、値のデータ型、許可された値、セマンティクスを文書化する必要があります。

戻り値

呼び出しが成功した場合は、SWbemObjectSet オブジェクトが返されます。

エラー コード

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

wbemErrAccessDenied - 2147749891 (0x80041003)

現在のユーザーに、呼び出しから返される 1 つ以上のクラスを表示する権限がありません。

wbemErrFailed - 2147749889 (0x80041001)

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

wbemErrInvalidParameter - 2147749896 (0x80041008)

無効なパラメーターが指定されました。

wbemErrOutOfMemory - 2147749894 (0x80041006)

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

解説

関連する WQL クエリ、ソース インスタンス、および関連付けオブジェクトの REFERENCES の詳細については、「ASSOCIATEDORS OF ステートメント」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
Header	Wbemdisp.h
タイプ ライブラリ	Wbemdisp.tlb
[DLL]	Wbemdisp.dll
CLSID	CLSID_SWbemObject
IID	IID_ISWbemObject

関連項目

SWbemObject

SWbemObject.Associators_

SWbemServices.AssociatorsOf

SWbemServices.ReferencesTo