VSS_RESTOREMETHOD_ENUM列挙 (vswriter.h)

[アーティクル]
08/27/2023

VSS_RESTOREMETHOD_ENUM列挙体は、ライターメタデータドキュメントを使用して、ライターが管理するすべてのコンポーネント内のすべてのファイルで使用される既定のファイル復元方法を指定するために、バックアップ時にライターによって使用されます。

復元方法はライター全体で、元の復元ターゲットとも呼ばれ、VSS_RT_ORIGINALのVSS_RESTORE_TARGET値によって示されます。

構文

typedef enum VSS_RESTOREMETHOD_ENUM {
  VSS_RME_UNDEFINED = 0,
  VSS_RME_RESTORE_IF_NOT_THERE,
  VSS_RME_RESTORE_IF_CAN_REPLACE,
  VSS_RME_STOP_RESTORE_START,
  VSS_RME_RESTORE_TO_ALTERNATE_LOCATION,
  VSS_RME_RESTORE_AT_REBOOT,
  VSS_RME_RESTORE_AT_REBOOT_IF_CANNOT_REPLACE,
  VSS_RME_CUSTOM,
  VSS_RME_RESTORE_STOP_START
} ;

定数


`VSS_RME_UNDEFINED` 値: 0 復元方法は定義されていません。これは、ライターの部分でエラーが発生したことを示します。この値は、高速ライターではサポートされていません。
`VSS_RME_RESTORE_IF_NOT_THERE` リクエスターは、のバージョンがない場合にのみ、選択したコンポーネントまたはコンポーネントセットのファイルを復元する必要がありますこれらのファイルは現在ディスク上にあります。ファイルの復元用に代替の場所マッピングが定義されていない限り、選択したコンポーネントまたはコンポーネントセットが現在ディスク上にあり、選択したコンポーネントによって管理されているファイルは存在しません。コンポーネントまたはコンポーネントセットを復元する必要があります。ファイルの代替ロケーション・マッピングが定義されていて、ファイルのバージョンがディスク上に存在する場合、ファイルのバージョンが存在しない場合にのみ、別の場所にファイルを書き込む必要があります。別の場所。
`VSS_RME_RESTORE_IF_CAN_REPLACE` リクエスターは、現在ディスク上のファイルを上書きできる場合にのみ、選択したコンポーネントまたはコンポーネントセットのファイルを復元する必要があります。ファイルの復元用に別の場所マッピングが定義されていない限り、は、ディスク上の選択したコンポーネントまたはコンポーネントセットを上書きすることはできません。コンポーネントまたはコンポーネントセットを復元する必要があります。ファイルの代替場所マッピングが定義されている場合は、ファイルを別の場所に書き込む必要があります。
`VSS_RME_STOP_RESTORE_START` リクエスターは、次のように復元操作を実行する必要があります。 PreRestore イベントを送信し、すべてのライターが処理するまで待ちます。サービスを停止します。ファイルを元の場所に復元します。サービスを再起動します。 PostRestore イベントを送信し、すべてのライターが処理するまで待ちます。停止するサービスは、 IVssCreateWriterMetadata::SetRestoreMethod メソッドを呼び出すときに、事前にライターを指定します。要求元は、 IVssExamineWriterMetadata::GetRestoreMethod メソッドを呼び出すことによって、サービスの名前を取得できます。停止中のサービスでライターがホストされている場合、サービスの停止と再起動時にライターインスタンス ID が変更されるため、そのライターは PostRestore イベントを受信しないことに注意してください。
`VSS_RME_RESTORE_TO_ALTERNATE_LOCATION` リクエスターは、選択したコンポーネントまたはコンポーネントセットのファイルを、で指定された場所に復元する必要があります。ライターコンポーネントメタデータファイルで指定された代替の場所マッピング。 (詳細については、 IVssCreateWriterMetadata::AddAlternateLocationMapping, IVssComponent::GetAlternateLocationMapping, IVssExamineWriterMetadata::GetAlternateLocationMapping, および IVssWMFiledesc::GetAlternateLocation.) この値は、高速ライターではサポートされていません。
`VSS_RME_RESTORE_AT_REBOOT` リクエスターは、コンピューターの再起動後に、選択したコンポーネントまたはコンポーネントセットのファイルを復元する必要があります。復元するファイルは一時的な場所にコピーする必要があり、リクエスターはを使用する必要があります MoveFileEx と MOVEFILE_DELAY_UNTIL_REBOOT フラグを設定して、これらのファイルの復元を完了します。コンピューターの再起動後に適切な場所に移動します。
`VSS_RME_RESTORE_AT_REBOOT_IF_CANNOT_REPLACE` 可能であれば、リクエスターは選択したコンポーネントまたはコンポーネントセットのファイルを正しいファイルに復元する必要があります場所をすぐに確認できます。ディスク上で選択したコンポーネントまたはコンポーネントセットによって管理されているいずれかのファイルのバージョンがある場合、を上書きすることはできません。その後、選択したコンポーネントまたはコンポーネントセットによって管理されているすべてのファイルを復元する必要がありますコンピューターが再起動された後。この場合、復元するファイルはディスク上の一時的な場所にコピーする必要があり、リクエスターはで MoveFileEx を使用する MOVEFILE_DELAY_UNTIL_REBOOT フラグを設定して、これらのファイルの復元を完了します。コンピューターの再起動後に適切な場所に移動します。
`VSS_RME_CUSTOM` リクエスターは、カスタム復元方法を使用して、選択したによって管理されているファイルを復元する必要がありますコンポーネントまたはコンポーネントセット。カスタム復元では、特定のライターにプライベートなファイル取得 API 関数またはプロトコルを使用できますシングルサインオンを構成します。このような復元では、ライターコンポーネントメタデータファイル内の情報を使用する必要はありません。 (詳細については、その他のカスタムバックアップと復元 information.) この値は、高速ライターではサポートされていません。
`VSS_RME_RESTORE_STOP_START` リクエスターは、次のように復元操作を実行する必要があります。 PreRestore イベントを送信し、すべてのライターが処理するまで待ちます。ファイルを元の場所に復元します。 PostRestore イベントを送信し、すべてのライターが処理するまで待ちます。サービスを停止します。サービスを再起動します。停止するサービスは、 IVssCreateWriterMetadata::SetRestoreMethod メソッドを呼び出すときに、ライターによって事前に指定されます。要求元は、 IVssExamineWriterMetadata::GetRestoreMethod メソッドを呼び出すことによって、サービスの名前を取得できます。

注釈

ライターは、バックアップ中に IVssCreateWriterMetadata::SetRestoreMethod を呼び出して、そのメタデータに目的の復元メソッドを指定することで、ライターメタデータドキュメントの復元メソッドを設定します。

要求者は、 IVssExamineWriterMetadata::GetRestoreMethod を呼び出してライターの要求された復元メソッドを取得し、それに応じて動作します。

restore メソッドは、特定のライターのすべてのコンポーネント内のすべてのファイルに適用されます。

ライターが IVssComponent::SetRestoreTarget でVSS_RT_ORIGINAL以外のVSS_RESTORE_TARGET値を設定すると、復元時にコンポーネントごとに復元方法がオーバーライドされる場合があります。

別の場所マッピングが定義されていない VSS_RME_RESTORE_TO_ALTERNATE_LOCATION の復元方法はライターエラーを構成し、リクエスターはそれをそのように報告する必要があります。

復元方法で、現在ディスク上のファイル (VSS_RME_RESTORE_IF_NOT_THERE、VSS_RME_RESTORE_IF_CAN_REPLACE、またはVSS_RME_RESTORE_AT_REBOOT_IF_CANNOT_REPLACE) の状態に関するチェックが必要な場合は、ファイル I/O 操作を使用して、復元を実際に続行する前にコンポーネント全体を復元できることを確認することをお勧めします。

これを行う最も安全な方法は、復元前に CreateFile を使用してすべてのターゲットファイルを排他的に開く (共有しない) 方法です。

VSS_RME_RESTORE_IF_NOT_THEREの場合は、CREATE_NEWの作成処理フラグも設定する必要があります。

開いている操作が成功した場合、復元は続行でき、 CreateFile によって返されるハンドルを使用して、復元されたデータを実際にディスクに書き込む必要があります。

そうでない場合は、メソッドに応じてエラーが返されるか、または別の場所マッピングがチェックされ、(使用可能な場合)、または次回の再起動時に復元用にステージングされたコンポーネントファイルが返されることがあります。

これは、システムのオーバーヘッドが原因で、非常に大きなコンポーネント (そのうちの一部に何千ものファイルがある可能性があります) の問題である可能性があります。

この場合、信頼性が低くても使用可能なオプションは、次の操作を行うことです。

現在ディスク上にあるすべてのファイルをコピーし、一時キャッシュに復元します。
現在ディスク上のファイルをバックアップファイルに置き換えようとします (2 番目の一時領域またはバックアップメディアのディスク上にある可能性があります)。
ファイルの復元に失敗した場合は、復元操作を終了し、元のファイルを一時的な場所からコピーし、再起動操作時に別の場所のマッピングまたは復元を続行します。

VSS でのバックアップと復元のファイルの場所の詳細については、「既定以外のバックアップと復元の場所」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
Header	vswriter.h