次の方法で共有


IVssComponent クラス (vswriter.h)

IVssComponent インターフェイスは、要求者のバックアップ コンポーネント ドキュメントに含まれるコンポーネントに関する情報を調べて変更するためのメソッドを含む C++ (COM ではない) インターフェイスです。

IVssComponent オブジェクトは、 IVssBackupComponents::AddComponent メソッドによるバックアップ操作中にバックアップ コンポーネント ドキュメントに明示的に追加されたコンポーネントに対してのみ取得できます。

IVssBackupComponents::AddRestoreSubcomponent を使用して復元操作中に明示的に追加されたコンポーネントに関する情報は、IVssComponent インターフェイスでは使用できません。

IVssComponent オブジェクトで使用できるコンポーネントと暗黙的に選択されたサブコンポーネントの両方に共通する情報には、次のものが含まれます。

  • バックアップのタイムスタンプ
  • 復元前/復元後のエラー メッセージ
  • メタデータを復元する
  • 復元対象
IVssComponent オブジェクト内の一部の情報はファイル単位であり、明示的に選択されたコンポーネントまたは暗黙的に選択されたサブコンポーネントによって管理されるファイルを参照できます。
  • 代替の場所マッピング
  • 部分ファイル
  • ダイレクト ターゲット
その他の情報は、バックアップ コンポーネント ドキュメントには含まれず、論理パスで表されるライターのコンポーネント階層に基づいて、適切なライター メタデータ ドキュメントと組み合わせて IVssComponent オブジェクトを使用して推論できます ( 「選択性と論理パスの操作」を参照してください)。

インターフェイスはライターまたはリクエスターで使用できますが、特定のメソッドはライターでのみサポートされています。 これにより、ライターは、新しいターゲットの追加などのバックアップまたは復元操作の変更を要求したり、別の場所の使用などの要求者アクションを学習したりできます。

次のメソッドは、 IVssComponent インターフェイスを返します。

継承

IVssComponent インターフェイスは、IUnknown インターフェイスから継承します。 IVssComponent には、次の種類のメンバーもあります。

メソッド

IVssComponent クラスには、これらのメソッドがあります。

 
IVssComponent::AddDifferencedFilesByLastModifyLSN

サポートされていません。 (IVssComponent.AddDifferencedFilesByLastModifyLSN)
IVssComponent::AddDifferencedFilesByLastModifyTime

ファイルセット (指定されたファイル) を、ファイル全体を使用してタイムスタンプ付きの増分バックアップまたは差分バックアップに含めるために、最終変更タイムスタンプに対して評価する必要があることを示すためにライターによって使用されます。
IVssComponent::AddDirectedTarget

AddDirectedTarget メソッドを使用すると、ライターは、復元時にファイルを復元するときに、そのファイル (ソース ファイル) を再マップする必要があることを示すことができます。
IVssComponent::AddPartialFile

AddPartialFile メソッドは、特定のファイルの一部のみをバックアップし、それらの部分をバックアップすることを示します。
IVssComponent::GetAdditionalRestores

GetAdditionalRestores メソッドは、増分または差分の復元操作中にライターによって使用され、特定のコンポーネントが完全に取得するために追加の復元操作を必要とするかどうかを判断します。
IVssComponent::GetAlternateLocationMapping

GetAlternateLocationMapping は、ファイルの復元のためにファイル セットの別の場所を返すために使用されます。 このメソッドは、ライターまたはリクエスターによって呼び出すことができます。
IVssComponent::GetAlternateLocationMappingCount

GetAlternateLocationMappingCount メソッドは、要求者がデータの復元に使用する代替の場所マッピングの数を返します。 ライターまたはリクエスターは、このメソッドを呼び出すことができます。
IVssComponent::GetBackupMetadata

GetBackupMetadata メソッドは、IVssComponent::SetBackupMetadata を使用して、CVssWriter::OnPrepareBackup による PrepareForBackup イベント中に設定された可能性がある、ライター固有のプライベート バックアップ メタデータを取得します。
IVssComponent::GetBackupOptions

GetBackupOptions メソッドは、IVssBackupComponents::SetBackupOptions を使用してリクエスターによって現在選択されているコンポーネントセットを管理するライターに指定されたバックアップ オプションを返します。
IVssComponent::GetBackupStamp

GetBackupStamp メソッドは、特定のコンポーネントのライターによって格納されているバックアップ スタンプ文字列を返します。
IVssComponent::GetBackupSucceeded

GetBackupSucceeded メソッドは、選択したコンポーネントまたはコンポーネント セットのすべてのファイルをVSS_FILE_RESTORE_STATUS列挙としてバックアップしようとした場合の完全な試行の状態を返します。
IVssComponent::GetComponentName

GetComponentName メソッドは、このコンポーネントの論理名を返します。
IVssComponent::GetComponentType

GetComponentType メソッドは、VSS_COMPONENT_TYPE列挙の観点からこのコンポーネントの型を返します。
IVssComponent::GetDifferencedFile

GetDifferencedFile メソッドは、増分バックアップまたは差分バックアップまたは差分バックアップまたは復元に参加するファイル セット (指定されたファイル) に関する情報を返します。つまり、それに関連付けられているバックアップと復元は、(部分ファイルを使用するのではなく) バックアップ メディアとの間でファイル全体がコピーされるかのように実装されます。
IVssComponent::GetDifferencedFilesCount

増分バックアップまたは復元をサポートするライターによって差分ファイルとしてマークされた、このコンポーネント (および定義されているコンポーネント セットのサブコンポーネント) 内のファイル仕様の数を返します。
IVssComponent::GetDirectedTarget

GetDirectedTarget メソッドは、ライターがバックアップ時に保存した情報をバックアップ コンポーネント ドキュメントに返して、ファイルを復元するときに、ファイル (ソース ファイル) を再マップする必要があることを示します。
IVssComponent::GetDirectedTargetCount

GetDirectedTargetCount メソッドは、現在のコンポーネントに関連付けられている対象指定の数を返します。 ライターまたはリクエスターは、このメソッドを呼び出すことができます。
IVssComponent::GetFileRestoreStatus

GetFileRestoreStatus メソッドは、選択したコンポーネントまたはコンポーネント セットのすべてのファイルをVSS_FILE_RESTORE_STATUS列挙として復元しようとした場合の状態を返します。
IVssComponent::GetLogicalPath

GetLogicalPath メソッドは、このコンポーネントの論理パスを返します。
IVssComponent::GetNewTarget

GetNewTarget メソッドは、選択したコンポーネントまたはコンポーネント セットの新しいファイル復元の場所を返します。
IVssComponent::GetNewTargetCount

GetNewTargetCount メソッドは、特定のコンポーネントに関連付けられている新しいターゲット復元場所の数を返します。
IVssComponent::GetPartialFile

GetPartialFile メソッドは、このコンポーネントに関連付けられている部分ファイルに関する情報を返します。
IVssComponent::GetPartialFileCount

GetPartialFileCount メソッドは、コンポーネントに関連付けられている部分ファイルの数を返します。
IVssComponent::GetPostRestoreFailureMsg

IVssComponent::SetPostRestoreFailureMsg が設定されている場合、GetPostRestoreFailureMsg メソッドは PostRestore イベントの処理中にライターによって生成されたエラー メッセージを返します。
IVssComponent::GetPreRestoreFailureMsg

IVssComponent::SetPreRestoreFailureMsg が設定されている場合、GetPreRestoreFailureMsg メソッドは、PreRestore イベントの処理中にライターによって生成されたエラー メッセージを取得します。
IVssComponent::GetPreviousBackupStamp

GetPreviousBackupStamp メソッドは、バックアップ コンポーネント ドキュメントで要求者によって読み込まれた以前のバックアップ スタンプを返します。 値は、ファイルを差分バックアップ操作または増分バックアップ操作に参加させる必要があるかどうかを決定するときに、ライターによって使用されます。
IVssComponent::GetRestoreMetadata

GetRestoreMetadata メソッドは、IVssComponent::SetRestoreMetadata を使用して、CVssWriter::OnPreRestore によって PreRestore イベント中に設定された可能性がある、ライター固有のプライベートな復元メタデータを取得します。
IVssComponent::GetRestoreOptions

GetRestoreOptions メソッドは、IVssBackupComponents::SetRestoreOptions を使用して、リクエスターによって現在のライターに指定された復元オプションを取得します。
IVssComponent::GetRestoreSubcomponent

GetRestoreSubcomponent メソッドは、特定のコンポーネントに関連付けられている指定されたサブコンポーネントを返します。
IVssComponent::GetRestoreSubcomponentCount

GetRestoreSubcomponentCount メソッドは、コンポーネントに関連付けられているサブコンポーネントの数を返します。
IVssComponent::GetRestoreTarget

GetRestoreTarget メソッドは、現在のコンポーネントの復元ターゲット (VSS_RESTORE_TARGET列挙の観点から) を返します。
IVssComponent::IsSelectedForRestore

IsSelectedForRestore メソッドは、現在のコンポーネントが復元対象として選択されているかどうかを判断します。
IVssComponent::SetBackupMetadata

SetBackupMetadata メソッドは、コンポーネントを使用してバックアップ メタデータを設定します。
IVssComponent::SetBackupStamp

SetBackupStamp メソッドは、バックアップがいつ行われたかを示す情報を含む文字列を設定します。
IVssComponent::SetPostRestoreFailureMsg

SetPostRestoreFailureMsg メソッドは、PostRestore イベントの処理中のエラーを説明するメッセージを作成するために使用されます。
IVssComponent::SetPreRestoreFailureMsg

SetPreRestoreFailureMsg メソッドは、PreRestore イベントの処理中のエラーを説明するメッセージを作成するために使用されます。
IVssComponent::SetRestoreMetadata

SetRestoreMetadata メソッドは、現在のコンポーネントのライター固有のメタデータを設定します。
IVssComponent::SetRestoreTarget

SetRestoreTarget メソッドは、現在のコンポーネントの復元ターゲット (VSS_RESTORE_TARGET列挙の観点から) を設定します。

要件

要件
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー vswriter.h (Vss.h、VsWriter.h を含む)