Share via

IVssExamineWriterMetadata::GetRestoreMethod メソッド (vsbackup.h)

  • [アーティクル]

GetRestoreMethod メソッドは、ライターがデータを復元する方法に関する情報を返します。

構文

HRESULT GetRestoreMethod(
  [out] VSS_RESTOREMETHOD_ENUM *pMethod,
  [out] BSTR                   *pbstrService,
  [out] BSTR                   *pbstrUserProcedure,
  [out] VSS_WRITERRESTORE_ENUM *pwriterRestore,
  [out] bool                   *pbRebootRequired,
  [out] UINT                   *pcMappings
);

パラメーター

[out] pMethod

ファイルの上書きを指定する VSS_RESTOREMETHOD_ENUM 値へのポインター。復元操作で使用されるメソッドを指定する別の場所の使用。

[out] pbstrService

pMethod の値がVSS_RME_STOP_RESTORE_STARTまたはVSS_RME_RESTORE_STOP_STARTの場合は、開始および停止されるサービスの名前を含む文字列へのポインター。 それ以外の場合、値は NULL です。

[out] pbstrUserProcedure

復元の実行方法をユーザーに説明する HTML または XML ドキュメントの URL へのポインター。 値は NULL である可能性があります。

[out] pwriterRestore

ライター がデータ の復元に関与するかどうかを指定するVSS_WRITERRESTORE_ENUM値へのポインター。

[out] pbRebootRequired

復元操作の完了後に再起動が必要かどうかを示すブール値へのポインター。 再起動が必要な場合は true 、それ以外の場合は false を受け取ります。

[out] pcMappings

ライターに関連付けられている代替マッピングの数へのポインター。

戻り値

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

値 意味
S_OK
 復元メソッドの情報が正常に返されました。
S_FALSE
 復元方法が存在しません。
E_INVALIDARG
 パラメーター値の 1 つが無効です。
E_OUTOFMEMORY
 呼び出し元がメモリやその他のシステム リソースを使い切れている。
VSS_E_INVALID_XML_DOCUMENT
 XML ドキュメントが無効です。 詳細については、イベント ログを確認してください。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。
VSS_E_UNEXPECTED
 予期しないエラー。 エラー コードは、エラー ログ ファイルに記録されます。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。

Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 R2 と Windows 7 まではサポートされません。 代わりに E_UNEXPECTED が使用されます。

注釈

呼び出し元は、SysFreeString を呼び出すことによって、pbstrUserProcedure パラメーターと pbstrService パラメーターで使用されるメモリを解放する必要があります。

次のいずれかが当てはまる場合は、常にファイルを別の場所マッピングに復元する必要があります。

  • 復元方法 (バックアップ時に設定) がVSS_RME_RESTORE_TO_ALTERNATE_LOCATION。
  • その復元ターゲットが (復元時に) VSS_RT_ALTERNATEに設定されました。
いずれの場合も、有効な代替ロケーション・マッピングが定義されていない場合、これはライター・エラーを構成します。

の場合、ファイルを別の場所マッピングに復元できます。

  • 復元方法はVSS_RME_RESTORE_IF_NOT_THEREであり、ファイルのバージョンは既にディスク上に存在します。
  • 復元方法がVSS_RME_RESTORE_IF_CAN_REPLACEされ、ファイルのバージョンがディスク上に存在し、置き換えることはできません。
ここでも、有効な代替場所マッピングが定義されていない場合、これはライター エラーを構成します。

代替の場所マッピングは復元操作中にのみ使用され、バックアップ操作中にのみ使用される代替パスと混同しないでください。

復元方法の詳細については、「 VSS 復元方法の設定」を参照してください。

復元方法がVSS_RME_STOP_RESTORE_STARTまたはVSS_RME_RESTORE_STOP_STARTの場合、リクエスターは pbstrService によって返される名前を使用して、復元中に停止する必要があるサービスを決定し、復元後に再起動する必要があります。 復元操作中 のサービスの停止と再起動 にライターが参加する方法については、「Requesters による復元のためのサービスの停止」を参照してください。

要件

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

こちらもご覧ください

IVssCreateWriterMetadata::SetRestoreMethod

IVssExamineWriterMetadata