IVssAsync::QueryStatus メソッド (vss.h)

QueryStatus メソッドは、非同期操作の状態を照会します。

構文

HRESULT QueryStatus(
  [out] HRESULT *pHrResult,
  [out] INT     *pReserved
);

[out] pHrResult

現在の IVssAsync オブジェクトを返した非同期操作の状態。

すべての IVssAsync オブジェクトに対する QueryStatus の呼び出しはすべて、次の状態コードをサポートします。

値	説明
VSS_S_ASYNC_CANCELLED	非同期操作は、以前の IVssAsync::Cancel の呼び出しによって取り消されました。
VSS_S_ASYNC_FINISHED	非同期操作が正常に完了しました。
VSS_S_ASYNC_PENDING	非同期操作はまだ実行中です。

追加の戻り値を返すことができますが、最初に IVssAsync オブジェクトを返したメソッドのリターンコードによって異なります。

[out] pReserved

このパラメーターの値は NULL である必要があります。

このメソッドの有効なリターンコードを次に示します。

値	説明
S_OK	クエリ操作が成功しました。
E_ACCESSDENIED	ユーザーに正しい特権がないため、クエリ操作に失敗しました。
E_INVALIDARG	pHrResult の戻り値を保持するために使用される変数へのポインターが NULL であるか、有効なメモリ位置ではありません。
VSS_E_UNEXPECTED	予期しないエラー。エラーコードは、エラーログファイルに記録されます。詳細については、「 VSS でのイベントとエラーの処理」を参照してください。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 R2 と Windows 7 まではサポートされません。代わりに E_UNEXPECTED が使用されます。

非同期操作の実行中にエラーが発生した場合、 QueryStatus は最初に IVssAsync オブジェクトを返したメソッドと同じエラーコードを返します。

特定のメソッドによって返される IVssAsync::QueryStatus オブジェクトの戻り値の完全な一覧を取得するには、そのメソッドに記載されているエラーコードを参照してください。