IVssCreateExpressWriterMetadata

IVssCreateExpressWriterMetadata インターフェイスは、エクスプレスライター用の Writer Metadata Document を構築するためのメソッドを含む COM インターフェイスです。

エクスプレスライターのコンポーネントがバックアップされる際に暗黙的に含まれてしまう可能性のあるファイルセット(指定された1つまたは複数のファイル)を除外します。

このメソッドの有効な戻り値は次のとおりです。

エクスプレスライターがサポートするのはローカルリソース、すなわち絶対パスが有効なローカルボリューム指定で始まるファイルセットのみであり、マップされたネットワークドライブは使用できません。したがって、AddExcludeFiles に渡すパス入力(wszPath)は(環境変数の解決後に)この形式である必要があります。たとえば、指定したディレクトリ内のすべてのファイルを含むコンポーネントを定義したうえで、AddExcludeFiles を使用して一部のファイル(たとえば一時ファイル)をバックアップから明示的に除外すると便利なことがよくあります。

ファイルの除外の詳細については、除外ファイルリストの指定を参照してください。

バックアップ対象となるエクスプレスライターのコンポーネントセットにファイルグループを追加します。

このメソッドの有効な戻り値は次のとおりです。

このメソッドは複数回呼び出して、エクスプレスライターのメタデータに複数のコンポーネントを追加できます。

指定したクラスの指定したインスタンスのライターの各コンポーネントについて、論理パスと名前の組み合わせは一意でなければなりません。同じ wszLogicalPath と wszComponentName の値で AddComponent を 2 回呼び出そうとすると、VSS_E_OBJECT_ALREADY_EXISTS エラーになります。

AddComponent は、サブコンポーネント、すなわちすべてのメンバーファイルがグループとしてバックアップされるものの、個別に復元できるファイルを含むコンポーネントを追加するために使用できます。詳細については、復元の選択可能性とサブコンポーネントの操作を参照してください。

エクスプレスライターの指定したファイルグループコンポーネントに、ファイルセット(指定された1つまたは複数のファイル)を追加します。

このメソッドの有効な戻り値は次のとおりです。

エクスプレスライターのデータをどのように復元するかを指定します。

このメソッドの有効な戻り値は次のとおりです。

エクスプレスライターが定義できる復元方法は 1 つだけです。復元方法がオーバーライドされない場合、エクスプレスライターのすべてのコンポーネントは同じ方法で復元されます。

エクスプレスライターは、通常 PreRestore イベント(CVssWriter::OnPreRestore)の処理中に復元ターゲットを設定することで、コンポーネントごとに復元方法をオーバーライドします。

復元方法はライター単位で適用されるにもかかわらず、実際にはコンポーネント単位で実装される点に注意することが重要です。たとえば、method パラメーターで指定された方法が VSS_RME_RESTORE_IF_CAN_REPLACE の場合、コンポーネント内のすべてのファイルは、エラーを発生させずにすべて置き換えられる場合に元の場所に復元されます。そうでない場合は、代替の場所が指定されていればそこに復元されます。

次のいずれかに該当する場合、ファイルは代替の場所のマッピングに復元できます。

• 復元方法が VSS_RME_RESTORE_IF_NOT_THERE で、そのファイルのバージョンが既にディスク上に存在する場合。
• 復元方法が VSS_RME_RESTORE_IF_CAN_REPLACE で、そのファイルのバージョンがディスク上に存在し、置き換えられない場合。

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

復元方法が VSS_RME_STOP_RESTORE_START または VSS_RME_RESTORE_STOP_START の場合、正しいサービス名を wszService 引数として指定する必要があります。復元操作中のサービスの停止と再起動へのライターの関与については、リクエスターによる復元のためのサービス停止を参照してください。

エクスプレスライターが管理するコンポーネントに明示的なライターコンポーネント依存関係があること、すなわち別のコンポーネント(場合によっては別のライターが管理)を一緒にバックアップおよび復元する必要があることを示せるようにします。

このメソッドの有効な戻り値は次のとおりです。

エクスプレスライターが、参加できるバックアップ操作の種類を自身の Writer Metadata Document に示すために使用します。

このメソッドの有効な戻り値は次のとおりです。

SetBackupSchema によってスキーマが明示的に設定されない場合、エクスプレスライターには既定値 VSS_BS_UNDEFINED が割り当てられます。VSS_BS_UNDEFINED は、ライターが(VSS_BT_FULL で定義される)ファイル全体の単純な完全バックアップと復元のみをサポートし、増分バックアップや差分バックアップはサポートせず、部分ファイルもサポートしないことを意味します。エクスプレスライターがサポートするバックアップスキーマの種類は、VSS_BS_UNDEFINED、VSS_BS_COPY、VSS_BS_INDEPENDENT_SYSTEM_STATE のみです。

リクエスターは IVssExamineWriterMetadata::GetBackupSchema を呼び出して、SetBackupSchema で設定されたライターのバックアップスキーマを取得します。

エクスプレスライターの状態情報を含む Writer Metadata Document を、指定した文字列に格納します。

このメソッドの有効な戻り値は次のとおりです。