次の方法で共有


IVMTask::WaitForCompletion メソッド

[Windows Virtual PC は、Windows 8の時点で使用できなくなりました。 代わりに、 Hyper-V WMI プロバイダー (V2) を使用します。

タスクが完了するか、指定したタイムアウト間隔が経過するまで待機します。

構文

HRESULT WaitForCompletion(
  [in] long timeout
);

パラメーター

timeout [in]

このメソッドがタスクの完了を待機してから呼び出し元に制御を返す時間 (ミリ秒単位)。 値 -1 は、タイムアウトせずにタスクが完了するまでメソッドが待機することを指定します。その他の有効なタイムアウト値の範囲は 0 ~ 4,000,000 ミリ秒です。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード/値 説明
S_OK
0
操作に成功しました。
E_INVALIDARG
0x80000003
タイムアウト パラメーターが無効です。
DISP_E_EXCEPTION
0x80020009
予期しないエラーが発生しました。

解説

WaitForCompletion メソッドは、現在の実行スレッドが戻るまでスリープ状態にします。 無限待機 (タイムアウト = -1) を指定することは、どのような状況でもタスクが完了することが絶対に重要でない限り、推奨されません。

必要条件

要件
サポートされている最小のクライアント
Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー
サポートなし
クライアント サポートの終了
Windows 7
製品
Windows Virtual PC
ヘッダー
VPCCOMInterfaces.h
IID
IID_IVMTaskは ab72b222-6e9c-48ae-aa54-85e3e635767c として定義されています

関連項目

IVMTask