ライター メタデータ ドキュメントの内容
ライター メタデータ ドキュメントには、ライターの識別と分類の情報、ライター レベルの仕様、およびコンポーネント データの 3 つのデータ セットが含まれています。
ライター識別情報
ライターの識別と分類の情報には、次のものが含まれます。
- ライター名
- Writer クラス ID
- ライター インスタンスの
- ライターによって管理されるデータをホスト システムで使用する方法 (VSS_USAGE_TYPEを参照)
- ライターによって管理されるデータの種類 (VSS_SOURCE_TYPEを参照)
ライター インスタンスは一意であり、CSVsWriter オブジェクトの初期化時にシステムによって生成されるライター インスタンスを除き、CSVsWriter::Initialize を呼び出すときにライターによって設定され、IVssExamineWriterMetadata::GetIdentityを呼び出すことによって要求者が使用できます。
ライター インスタンスは一意に生成されるため、格納されているライター メタデータ ドキュメントから取得された格納されたライター インスタンスは役に立たない可能性があります。
VSS_USAGE_TYPEチェックすると、アプリケーションは、ライターが一般的なアプリケーション データを管理しているか、または機能するファイルがシステムのブート状態の一部であるか、システム サービスによって使用されているかを判断できます。 バックアップと復元のアプリケーションでは、システムの安定性を維持するために使用の種類を考慮する必要があります。
VSS_SOURCE_TYPE フラグは、バックアップするデータを管理するライターが通常の操作中に実行するアプリケーションの種類を示します。
現時点では、ライターがトランザクション データベース操作または非トランザクション データベース操作の一部としてファイルを生成するかどうか、またはファイルがより一般的な種類のアクティビティの結果であるかどうかを指定することに制限されています。 この一覧は、時間の経過と同時に増加する可能性があります。 この情報は、ライターのファイルで期待される通常のレベルのアクティビティを決定する際に役立ちます。
Writer-Level の仕様
ライター レベルの仕様には、1 つのコンポーネントが管理するデータに関係なく、すべてのデータに適用される、そのスコープ内のライター全体の情報が含まれています。
必要に応じて、次を指定できます。
- ファイル一覧を除外する
- 復元に 代替の場所マッピング
インクルードおよび除外ファイルリストには、コンポーネント内のそれ以外のファイル情報が含まれており、その仕様はコンポーネントの仕様よりも優先されます。
復元方法の仕様
復元方法 は、IVssCreateWriterMetadata::SetRestoreMethodをライター メタデータ ドキュメントで設定され、IVssExamineWriterMetadata::GetRestoreMethodをしたリクエスターによって取得されます。
復元方法を設定する場合、ライターは、ライターによって管理されるすべてのファイルに対して、ファイル復元の推奨される方法 (元の復元ターゲットとも呼ばれます) を示します。 たとえば、復元メソッドは、ライターによって管理されているすべてのファイルが現在ディスク上のファイルを上書きできるかどうかを指定します。 (詳細については、「VSS 復元構成の と VSS_RESTOREMETHOD_ENUM」を参照してください)。
ファイル 一覧の指定を除外する
除外リストを使用すると、特定のファイルがバックアップ セットに含まれるのを明示的に防ぐことで、コンポーネント内のワイルドカード仕様を微調整できます。
たとえば、コンポーネントには、c:\Database\*.* のファイル仕様を含むファイル セットがある場合があります。 これは便利な定義ですが、場合によっては一時ファイルが生成される場合があり (おそらく*.tmp形式)、ライターは常にバックアップを防止したいと考えています。
この場合、ライターは、IVssCreateWriterMetadata::AddExcludeFilesを使用して、*.tmpを除外リストに追加します。 この仕様は再帰的である可能性があります。
要求者は、IVssExamineWriterMetadata::GetExcludeFileを使用して、この情報を照会します。
除外ファイルリストは、コンポーネントファイルリストよりも優先されます。
したがって、ライター メタデータ ドキュメントでバックアップ用に指定されたファイルの一覧は、明示的にコンポーネントに含まれるで指定されたすべてのファイルと、暗黙的に含まれる コンポーネントで構成されます。除外されるファイルはすべて含まれません。
別の場所マッピングの仕様
代替の場所マッピングは、ライター メタデータ ドキュメントの作成時に最初に設定され、元の場所にファイルを復元できない場合にファイルを復元できるディスク上の場所を示します。
この情報は、IVssCreateWriterMetadata::AddAlternateLocationMapping を使用して null で終わるワイド文字列として追加され、IVssExamineWriterMetadata::GetAlternateLocationMapping によって IVssWMFiledescオブジェクトとして取得されます。
代替の場所マッピングは、ライター レベルのインターフェイス (IVssCreateWriterMetadata と IVssExamineWriterMetadata) を使用して指定および検査されるにもかかわらず、ファイル セットで指定されます。 別の場所マッピング (パス、ファイル指定、再帰フラグ) の指定に使用するファイル セットは、ライターのコンポーネントのいずれかに既に追加されているファイル セットの 1 つと一致する必要があります (「コンポーネントへのファイルの追加を参照してください)。
詳細については、「既定以外のバックアップと復元の場所 」を参照してください。
Component-Level 情報
コンポーネント は、バックアップと復元の目的で論理ユニットを形成するファイルのコレクションです。 コンポーネント内のすべてのファイル (明示的に除外されたものを除く) は、1 つのユニットとしてバックアップおよび復元する必要があります。
ライターは、次のコンポーネント情報を指定 IVssCreateWriterMetadata::AddComponentを使用してコンポーネントを追加します。
- 種類
- 名前
- 論理パス (存在する場合)
- サポートされている機能
- Selectability
- 復元中にライターによって使用されるメタデータ
- 情報を表示する
- 通知情報
バックアップ の選択性と復元のの選択性は互いに完全に独立しており、ライターはそれらを論理パスと組み合わせて使用して、管理するさまざまなコンポーネント間の関係を示します。 ライターは、明示的に含まれるに必要なコンポーネント (要求者の裁量で明示的に含めることができるコンポーネント) と、暗黙的に含めることができるコンポーネント 暗黙的に含めることができるコンポーネント示すことができます。 (「選択可能性と論理パスの使用 」を参照してください)。
ファイルは、IVssCreateWriterMetadata::AddFilesToFileGroup 、IVssCreateWriterMetadata::AddDatabaseFiles、または IVssCreateWriterMetadata::AddDatabaseLogFilesを使用して、特定のコンポーネントに追加されます。 (「コンポーネントへのファイルの追加」を参照してください)。
バックアップ中にコンポーネントにファイルを追加する場合、ライターは、バックアップするファイルを定義するファイル セット (パス、ファイル指定、再帰フラグ) を指定する必要があります。
ライターは、バックアップ用の 代替パス を指定することもできます。これは、前述代替場所マッピング混同しないでください。 この代替パスは、ボリュームのバックアップ時にファイルのコピー元となる既定以外の場所を示します。
ライター メタデータ ドキュメント内の特定のコンポーネントに関する情報は、IVssExamineWriterMetadata::GetComponentによって返される IVssWMComponent インターフェイスを介して取得できます。
ファイルとパスは、IVssWMFiledescオブジェクトとして IVssWMComponent返されます。
ライターのコンポーネント情報については、「ライターによるコンポーネントの定義 で詳しく説明します。