バックアップコンポーネントドキュメントの内容

[アーティクル]
06/13/2023

バックアップコンポーネントドキュメントは、 IVssBackupComponents インターフェイスのインスタンスによって管理されます。このインターフェイスには、バックアップ操作の制御、シャドウコピーの操作、システム状態のクエリを行うさまざまな方法も含まれています。ただし、このインターフェイスを介してドキュメントのすべての情報に直接アクセスできるわけではありません。

バックアップコンポーネントドキュメントは、次のいくつかのデータセットで構成されています。

バックアップ操作または復元操作に明示的に含まれていたコンポーネントに関する情報
格納されているコンポーネントとライター情報の表現
バックアップ/回復操作に関する状態情報

リクエスターとライターの両方でコンポーネント情報を使用できる一方で、状態情報にアクセスできるのはライターだけです。

コンポーネント包含情報

バックアップコンポーネントドキュメントには、リクエスターによるバックアップと復元に明示的に含まれるコンポーネントの一覧が含まれています。この一覧には、次のものが含まれます。

選択可能 なコンポーネントを明示的に含む。

これらのファイルをバックアップ操作に含めることは、 IVssBackupComponents::AddComponents::AddComponent と 、IVssBackupComponents::SetSelectedForRestore による復元操作で示されます。
バックアップコンポーネントの先祖を選択できないバックアップサブコンポーネントの場合は選択できません。

ライターのコンポーネントを操作に含める場合は、これらすべてのコンポーネントを含める必要があります。これらのファイルをバックアップ操作に含めることは、 IVssBackupComponents::AddComponents::AddComponent と 、IVssBackupComponents::SetSelectedForRestore による復元操作で示されます。
復元用に選択でき、明示的に復元に追加されるバックアップ (サブコンポーネント) に暗黙的に追加されるコンポーネント。

これらのコンポーネントは選択可能でも非選択でもかまいませんが、バックアップ用に暗黙的に選択するために使用された選択可能な先祖があります。これらは、 IVssBackupComponents::AddRestoreSubcomponent によってバックアップコンポーネントドキュメントに追加されます。

復元に暗黙的に含まれるコンポーネントの ID は、バックアップコンポーネントドキュメントに格納されません。

VSS は、コンポーネントの包含に関する情報にアクセスできます。復元またはバックアップにコンポーネントが明示的に含まれていないライターは、 PrepareForBackup または PreRestore イベントの生成後に VSS イベントを受信しません。

ライターは、この情報に対して直接クエリを実行することはできません。仕様上、個々の VSS ライターはシステム上の他のライターの状態に関する詳細情報を必要とせず、前述のように、コンポーネントが含まれていないものは VSS 操作に参加する必要がないため、これは重要な制限ではありません。

要求者は、どのコンポーネントが操作に明示的に含まれているかを判断できます。

IVssBackupComponents::GetWriterComponentsCount メソッドは、(ドキュメント内のコンポーネントの数ではなく) バックアップコンポーネントドキュメントに格納されているコンポーネント情報を含むライターの数を返します。

リクエスターは、 IVssBackupComponents::GetWriterComponents を使用して格納されているライター情報を通じてインデックスを作成します。 IVssWriterComponentsExt インターフェイスのインスタンスを返します。 IVssWriterComponentsExt インターフェイスを使用すると、リクエスターは、参加しているライターのライタークラスとライターインスタンスを取得したり、バックアップコンポーネントドキュメントに格納されているコンポーネントに関する情報にアクセスしたりできます。

含まれるコンポーネントに関する情報

IVssComponent インターフェイスのインスタンスを介してアクセスされる、バックアップコンポーネントドキュメントのコンポーネントデータの表現 (パスとファイルの仕様情報は含まれません)。

要求者とライターは、さまざまな方法で IVssComponent インターフェイスのインスタンスへのアクセスを取得します。

リクエスターは、IVssBackupComponents::GetWriterComponents によって返される IVssWriterComponentsExt インターフェイスのインスタンスを使用して、ライターごとにコンポーネントデータを調べます。

ライター識別情報に加えて、 IVssWriterComponentsExt インターフェイスは、 IVssComponent インターフェイスのインスタンスの配列を提供します。選択したライターに含まれるコンポーネントごとに 1 つ。

バックアップコンポーネントドキュメントのライフサイクルで説明したように、ライターは PrepareForBackup、PrepareForSnapshot、PostSnapshot、BackupComplete、PreRestore、または PostRestore イベントを処理するときに、IVssWriterComponents インターフェイスを介して同じ情報にアクセスできます。

IVssComponent を使用すると、ライターと要求者の両方が次の情報を取得できます。