ISWbemSinkEvents::OnProgress イベント

SWbemSink の OnProgress イベントは、非同期呼び出しが、進行中の呼び出しの状態を返したときにトリガーされます。 状態の更新をサポートするプロバイダーからイベント、インスタンス、またはクラスが生成される場合、このイベントにコードを記述することで、非同期操作の状態に関するフィードバックをユーザーに提供できます。 状態の更新情報を受信する必要がある場合、wbemFlagSendStatus (128/0x80) の非同期呼び出しの iFlags パラメーターを設定する必要があります。それ以外の場合、このイベントはトリガーされません。

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

構文

SWbemSink.OnProgress( _
  ByVal iUpperBound, _
  ByVal iCurrent, _
  ByVal strMessage, _
  ByVal objWbemAsyncContext _
)

パラメーター

iUpperBound

完了するタスクの総数を表す整数。

iCurrent

現在処理中の項目。

strMessage

現在のタスクの状態を説明するメッセージ。

objWbemAsyncContext

元の非同期呼び出しに渡される SWbemNamedValueSet オブジェクト。 このパラメーターは、このオブジェクト シンクを使用して複数の非同期呼び出しが行われたときにこのイベントをトリガーする、非同期呼び出しの開始元を識別するために使用します。

戻り値

このイベントでは値は返されません。

エラー コード

OnProgress イベントの完了後、Err オブジェクトに下記のいずれかのエラー コードが格納されている場合があります。

wbemErrFailed - 2147749889 (0x80041001)

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

wbemErrOutOfMemory - 2147749894 (0x80041006)

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

wbemErrTransportFailure - 2147749909 (0x80041015)

ネットワーク エラーが発生して、通常の操作が妨げられていました。

解説

OnProgress イベントは、非同期呼び出しが、進行中の呼び出しの状態を返したときにトリガーされます。 状態の更新をサポートするプロバイダーからイベント、インスタンス、またはクラスが生成される場合、このイベントにコードを記述することで、非同期操作の状態に関するフィードバックをユーザーに提供できます。

注意

非同期コールバックを使用すると、認証されていないユーザーがシンクにデータを提供できます。 これは、スクリプトとアプリケーションに対するセキュリティ リスクとなります。 リスクを排除するには、半同期または同期通信を使用します。 詳細については、メソッドの呼び出しに関するページを参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
Header	Wbemdisp.h
IDL	Wbemdisp.idl
[DLL]	Wbemdisp.dll
CLSID	CLSID_SWbemSink
IID	IID_ISWbemSinkEvents

関連項目

SWbemSink