SWbemServices.InstancesOfAsync メソッド

SWbemServices オブジェクトの InstancesOfAsync メソッドを使用すると、ユーザー指定の条件に従って、指定したクラスのインスタンスを取得できます。

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

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

構文

SWbemServices.InstancesOfAsync( _
  ByVal ObjWbemSink, _
  ByVal strClass, _
  [ ByVal iFlags ], _
  [ ByVal objWbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

パラメーター

ObjWbemSink

インスタンスを非同期的に受け取るオブジェクト シンク。 オブジェクトを受信する SWbemSink オブジェクトを作成します。

strClass

必須。 必要なインスタンスのクラスの名前を含む文字列。 このパラメーターを空白にすることはできません。

iFlags [省略可能]

呼び出し列挙の深さと、呼び出しがすぐに返されるかどうかを決定します。 このパラメーターには次の値を指定できます。

wbemQueryFlagShallow (1 (0x1))

指定した親クラスの直接サブクラスのみが強制的に列挙に含まれます。

wbemQueryFlagDeep (0 (0x0))

このパラメーターの既定値。 この値を使用すると、階層内のすべてのクラスが強制的に列挙に含まれます。

wbemFlagSendStatus (128 (0x80))

非同期呼び出しからオブジェクト シンクの OnProgress イベント ハンドラーに状態更新が送信されるようにします。

wbemFlagDontSendStatus (0 (0x0))

非同期呼び出しからオブジェクト シンクの OnProgress イベント ハンドラーに状態の更新が送信されないようにします。

wbemFlagUseAmendedQualifiers (131072 (0x20000))

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

戻り値

このメソッドは値を返しません。 成功した場合、シンクはインスタンスごとに OnObjectReady イベントを受け取ります。 最後のインスタンスの後、オブジェクト シンクは OnCompleted イベントを受け取ります。

エラー コード

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

wbemErrAccessDenied - 2147749891 (0x80041003)

現在のユーザーには、指定されたクラスのインスタンスを表示する権限がありません。

wbemErrFailed - 2147749889 (0x80041001)

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

wbemErrInvalidClass - 2147749904 (0x80041010)

指定されたクラスが無効です。

wbemErrInvalidParameter - 2147749896 (0x80041008)

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

wbemErrOutOfMemory - 2147749894 (0x80041006)

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

解説

この呼び出しはすぐに返されます。 要求されたオブジェクトと状態は、objWbemSink で指定されたシンクに配信されるコールバックを通じて呼び出し元に返されます。 オブジェクトが返されたら、それぞれを都度処理するには、objWbemSink.OnObjectReady イベント サブルーチンを作成します。 すべてのオブジェクトが返されたら、objWbemSink.OnCompleted イベントの実装で最終処理を実行できます。

非同期コールバックを使用すると、認証されていないユーザーがシンクにデータを提供できます。 これにより、スクリプトとアプリケーションにセキュリティ リスクが発生します。 リスクを排除するには、「非同期呼び出しでのセキュリティの設定」を参照してください

InstancesOfAsync メソッドは、クラス オブジェクトに対してのみ機能します。 返された列挙子に要素が含まれていないことは、エラーではありません。

必要条件

関連項目

SWbemServices

メソッドの呼び出し