IVssBackupComponents::QueryRevertStatus メソッド (vsbackup.h)

  • [アーティクル]

QueryRevertStatus メソッドは、元に戻す操作の状態を判断するために使用できる IVssAsync インターフェイス ポインターを返します。

構文

HRESULT QueryRevertStatus(
  [in]  VSS_PWSZ  pwszVolume,
  [out] IVssAsync **ppAsync
);

パラメーター

[in] pwszVolume

ボリュームの名前を含む Null で終わるワイド文字列。 名前は次のいずれかの形式にする必要があり、末尾に円記号 (\) を含める必要があります。

  • マウントされたフォルダーのパス (Y:\MountX\ など)
  • ドライブ文字 (D:\ など)
  • \\?\Volume{GUID}\ という形式のボリューム GUID パス ( GUID はボリュームを識別します)

[out] ppAsync

元に戻すプロセスの状態を取得するために使用できる IVssAsync インターフェイス ポインターを受け取る場所へのポインター。 操作が完了したら、呼び出し元は IUnknown::Release メソッドを呼び出してインターフェイス ポインターを解放する必要があります。

戻り値

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

値 意味
S_OK
 操作に成功しました。
E_ACCESSDENIED
 呼び出し元プロセスに十分な特権がありません。
E_FAIL
 内部エラーが発生しています。
E_INVALIDARG
 渡されたパラメーターの 1 つが無効です。
E_NOTIMPL
 ボリュームのプロバイダーは、元に戻す操作をサポートしていません。
E_OUTOFMEMORY
 呼び出し元がメモリやその他のシステム リソースを使い切れている。
E_POINTER
 必要なポインター パラメーターの 1 つが NULL です。
VSS_E_OBJECT_NOT_FOUND
 pwszVolume パラメーターが有効なボリュームではありません。
VSS_E_VOLUME_NOT_SUPPORTED
 このボリュームでは、Revert はサポートされていません。

注釈

コンピューターが再起動された場合でも元に戻す操作は続行され、別の方法を使用して作成されたバックアップを復元する場合を除き、取り消したり元に戻したりすることはできません。 返された に対する QueryStatus メソッド
IVssAsync インターフェイスは 、VSS_S_ASYNC_CANCELLED を返すことはできません。これは、元に戻す操作を開始した後に取り消すことができないためです。

要件

要件 値
サポートされている最小のクライアント WINDOWS Vista と SP1 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008、Windows Server 2003 SP1 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー vsbackup.h (VsBackup.h、Vss.h、VsWriter.h を含む)
Library VssApi.lib

こちらもご覧ください

IVssAsync

IVssBackupComponents

IVssBackupComponents::RevertToSnapshot