IVssBackupComponents クラス (vsbackup.h)
IVssBackupComponents インターフェイスは、ファイルの状態に関するライターをポーリングし、バックアップ/復元操作を実行するために、リクエスターによって使用されます。
アプリケーションは、 CreateVssBackupComponents を呼び出して IVssBackupComponents インターフェイスのインスタンスを取得します。
IVssBackupComponents オブジェクトは、1 つのバックアップ、復元、またはクエリ操作にのみ使用できます。
バックアップ、復元、または クエリ 操作が正常に終了するか、明示的に終了した後、要求元は IVssBackupComponents ::Release を呼び出して IVssBackupComponents オブジェクトを解放する必要があります。 IVssBackupComponents オブジェクトを再利用することはできません。 たとえば、Query 操作に既に使用したのと同じ IVssBackupComponents オブジェクトを使用して、バックアップ操作または復元操作を実行することはできません。
継承
IVssBackupComponents インターフェイスは、IUnknown インターフェイスから継承されます。 IVssBackupComponents には、 次の種類のメンバーもあります。
メソッド
IVssBackupComponents クラスには、これらのメソッドがあります。
| IVssBackupComponents::AbortBackup AbortBackup メソッドは、バックアップ操作が終了したことを VSS に通知します。 |
| IVssBackupComponents::AddAlternativeLocationMapping AddAlternativeLocationMapping メソッドは、指定されたコンポーネント内のファイル セットのすべてのメンバーを復元するために代替の場所マッピングが使用されたことを示すために、リクエスターによって使用されます。 |
| IVssBackupComponents::AddComponent バックアップ セットに明示的に追加するために使用されます。 |
| IVssBackupComponents::AddNewTarget AddNewTarget メソッドは、バックアップ アプリケーションがファイルを新しい場所に復元することを計画していることを示すために、復元操作中にリクエスターによって使用されます。 |
| IVssBackupComponents::AddRestoreSubcomponent コンポーネント セットのサブコンポーネント メンバーが復元されることを示します。このメンバーは、バックアップでは選択できませんが、復元は選択可能とマークされています。 |
| IVssBackupComponents::AddToSnapshotSet AddToSnapshotSet メソッドは、元のボリュームまたは元のリモート ファイル共有をシャドウ コピー セットに追加します。 |
| IVssBackupComponents::BackupComplete BackupComplete メソッドを使用すると、VSS は BackupComplete イベントを生成します。これにより、バックアップ プロセスが完了したことをライターに通知します。 |
| IVssBackupComponents::BreakSnapshotSet BreakSnapshotSet メソッドを使用すると、VSS によってシャドウ コピー セットの存在が "忘れ" されます。 |
| IVssBackupComponents::D eleteSnapshots DeleteSnapshots メソッドは、1 つ以上のシャドウ コピーまたはシャドウ コピー セットを削除します。 |
| IVssBackupComponents::D isableWriterClasses DisableWriterClasses メソッドを使用すると、ライターの特定のクラスがイベントを受信できなくなります。 |
| IVssBackupComponents::D isableWriterInstances DisableWriterInstances メソッドは、指定されたライター インスタンスまたはインスタンスを無効にします。 |
| IVssBackupComponents::D oSnapshotSet このセット内のすべてのシャドウ コピーを同時にコミットします。 |
| IVssBackupComponents::EnableWriterClasses EnableWriterClasses メソッドを使用すると、指定したライターがすべてのイベントを受信できます。 |
| IVssBackupComponents::ExposeSnapshot ExposeSnapshot メソッドは、シャドウ コピーをドライブ文字、マウントされたフォルダー、またはファイル共有として公開します。 |
| IVssBackupComponents::FreeWriterMetadata FreeWriterMetadata メソッドは、IVssBackupComponents::GatherWriterMetadata が呼び出されたときに割り当てられたシステム リソースを解放します。 |
| IVssBackupComponents::FreeWriterStatus FreeWriterStatus メソッドは、IVssBackupComponents::GatherWriterStatus の呼び出し中に割り当てられたシステム リソースを解放します。 |
| IVssBackupComponents::GatherWriterMetadata GatherWriterMetadata メソッドは、収集したメタデータの送信を各ライターに求めます。 メソッドは、ライターと通信するための Identify イベントを生成します。 |
| IVssBackupComponents::GatherWriterStatus GatherWriterStatus メソッドは、各ライターにステータス メッセージの送信を求めます。 |
| IVssBackupComponents::GetSnapshotProperties GetSnapshotProperties メソッドは、指定したシャドウ コピーのプロパティを取得します。 |
| IVssBackupComponents::GetWriterComponents GetWriterComponents メソッドは、要求者のバックアップ コンポーネント ドキュメントに格納されている特定のライターのコンポーネントに関する情報を返すために使用されます。 |
| IVssBackupComponents::GetWriterComponentsCount GetWriterComponentsCount メソッドは、要求者のバックアップ コンポーネント ドキュメントにコンポーネントが追加されたライターの数を返します。 |
| IVssBackupComponents::GetWriterMetadata GetWriterMetadata メソッドは、システムで実行されている特定のライターのメタデータを返します。 |
| IVssBackupComponents::GetWriterMetadataCount GetWriterMetadataCount メソッドは、メタデータを含むライターの数を返します。 |
| IVssBackupComponents::GetWriterStatus GetWriterStatus メソッドは、指定したライターの状態を返します。 |
| IVssBackupComponents::GetWriterStatusCount GetWriterStatusCount メソッドは、状態を持つライターの数を返します。 |
| IVssBackupComponents::ImportSnapshots 別のコンピューターから転送されたシャドウ コピーをインポートします。 |
| IVssBackupComponents::InitializeForBackup InitializeForBackup メソッドは、バックアップの準備としてバックアップ コンポーネントのメタデータを初期化します。 |
| IVssBackupComponents::InitializeForRestore InitializeForRestore メソッドは、復元操作に備えて IVssBackupComponents インターフェイスを初期化します。 |
| IVssBackupComponents::IsVolumeSupported IsVolumeSupported メソッドは、指定されたプロバイダーが、指定したボリュームまたはリモート ファイル共有のシャドウ コピーをサポートするかどうかを決定します。 |
| IVssBackupComponents::P ostRestore PostRestore メソッドを使用すると、VSS は PostRestore イベントを生成し、現在の復元操作が完了したことをライターに通知します。 |
| IVssBackupComponents::P repareForBackup PrepareForBackup メソッドを使用すると、VSS によって PrepareForBackup イベントが生成され、ライターは今後のバックアップ操作に備えるシグナルを生成します。 これにより、リクエスターのバックアップ コンポーネント ドキュメントをライターが使用できるようになります。 |
| IVssBackupComponents::P reRestore PreRestore メソッドを使用すると、VSS は PreRestore イベントを生成し、ライターに通知して、今後の復元操作を準備します。 |
| IVssBackupComponents::Query Query メソッドは、システム上のプロバイダー、または現在のコンテキストに存在するシステム内の完成したシャドウ コピーに対してクエリを実行します。 メソッドは、バックアップ操作中にのみ呼び出すことができます。 |
| IVssBackupComponents::QueryRevertStatus 元に戻す操作の状態を確認するために使用できる IVssAsync インターフェイス ポインターを返します。 (IVssBackupComponents.QueryRevertStatus) |
| IVssBackupComponents::RevertToSnapshot ボリュームを以前のシャドウ コピーに戻します。 (IVssBackupComponents.RevertToSnapshot) |
| IVssBackupComponents::SaveAsXML SaveAsXML メソッドは、要求者の状態情報を含むバックアップ コンポーネント ドキュメントを指定された文字列に保存します。 バックアップ コンポーネント ドキュメントを含むこの XML ドキュメントは、常にバックアップ操作の一部として安全に保存する必要があります。 |
| IVssBackupComponents::SetAdditionalRestores SetAdditionalRestores メソッドは、増分または差分復元操作中にリクエスターによって使用され、特定のコンポーネントが完全に取得するために追加の復元操作を必要とすることをライターに示します。 |
| IVssBackupComponents::SetBackupOptions SetBackupOptions メソッドは、コンポーネントのプライベートまたはライターに依存するバックアップ パラメーターの文字列を設定します。 |
| IVssBackupComponents::SetBackupState SetBackupState メソッドは、バックアップ操作の全体的な構成を定義します。 |
| IVssBackupComponents::SetBackupSucceeded SetBackupSucceeded メソッドは、特定のライターの指定されたコンポーネントのバックアップが成功したかどうかを示します。 |
| IVssBackupComponents::SetContext SetContext メソッドは、後続のシャドウ コピー関連の操作のコンテキストを設定します。 |
| IVssBackupComponents::SetFileRestoreStatus SetFileRestoreStatus メソッドは、一部のファイル、すべて、またはファイルが正常に復元されたかどうかを示します。 |
| IVssBackupComponents::SetPreviousBackupStamp SetPreviousBackupStamp メソッドは、差分または増分バックアップ操作の基になる、以前のバックアップ操作のバックアップ スタンプを設定します。 |
| IVssBackupComponents::SetRangesFilePath SetRangesFilePath メソッドは、部分的なファイル操作で範囲ファイルが必要であり、そのファイルが元のファイル以外の場所に復元された場合に使用されます。 |
| IVssBackupComponents::SetRestoreOptions SetRestoreOptions メソッドは、ライター コンポーネントのプライベートまたはライターに依存する復元パラメーターの文字列を設定します。 |
| IVssBackupComponents::SetRestoreState SetRestoreState メソッドは、復元操作の全体的な構成を定義します。 |
| IVssBackupComponents::SetSelectedForRestore SetSelectedForRestore メソッドは、指定した選択可能なコンポーネントが復元用に選択されているかどうかを示します。 |
| IVssBackupComponents::StartSnapshotSet StartSnapshotSet メソッドは、新しい空のシャドウ コピー セットを作成します。 |
要件
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | vsbackup.h (VsBackup.h、Vss.h、VsWriter.h を含む) |