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 オブジェクトの戻り値の完全な一覧を取得するには、そのメソッドに記載されているエラー コードを参照してください。

要件

   
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー vss.h
Library VssApi.lib

関連項目

IVssAsync

IVssBackupComponents::D oSnapshotSet

IVssBackupComponents::GatherWriterMetadata

IVssBackupComponents::GatherWriterStatus

IVssBackupComponents::ImportSnapshots

IVssBackupComponents::P ostRestore

IVssBackupComponents::P reRestore

IVssBackupComponents::P repareForBackup