SWbemServices.ReferencesTo メソッド

SWbemServices オブジェクトの ReferencesTo メソッドでは、特定のソース クラスまたはインスタンスを参照するすべての関連付けクラスまたはインスタンスのコレクションを返します。 このメソッドでは、REFERENCES OF WQL クエリで実行するのと同じ関数を実行します。

このメソッドは、半同期モードで呼び出されます。 詳細については、メソッドの呼び出しに関するページを参照してください。

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

構文

objWbemObjectSet = .ReferencesTo( _
  ByVal strObjectPath, _
  [ ByVal strResultClass ], _
  [ ByVal strRole ], _
  [ ByVal bClassesOnly ], _
  [ ByVal bSchemaOnly ], _
  [ ByVal strRequiredQualifier ], _
  [ ByVal iFlags ], _
  [ ByVal objWbemNamedValueSet ] _
)

パラメーター

strObjectPath

必須。 このメソッドのソースのオブジェクト パスを含む文字列。 詳細については、「WMI オブジェクトの場所を説明する」を参照してください。

strResultClass [省略可能]

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

strRole [省略可能]

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

bClassesOnly [省略可能]

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

bSchemaOnly [省略可能]

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

strRequiredQualifier [省略可能]

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

iFlags [省略可能]

操作に追加のフラグを指定する整数。 このパラメーターの既定値は 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 [オプション]

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

戻り値

メソッドが成功した場合、メソッドでは SWbemObjectSet オブジェクトを返します。

エラー コード

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

注意

要素を含まないコレクションが返されても、エラーではありません。

wbemErrAccessDenied - 2147749891 (0x80041003)

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

wbemErrFailed - 2147749889 (0x80041001)

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

wbemErrInvalidParameter - 2147749896 (0x80041008)

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

wbemErrOutOfMemory - 2147749894 (0x80041006)

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

wbemFlagUseAmendedQualifiers - 131072 (0x20000)

WMI で基底クラス定義と共にクラス変更データを返すようにします。

解説

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

要件

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

関連項目

SWbemServices

SWbemObject.Associators_

SWbemObject.References_

SWbemServices.AssociatorsOf