CVssWriter クラス (vswriter.h)
CVssWriter クラスは、ライターが VSS やその他のライターと状態を同期するインターフェイスを定義する抽象基本クラスです。
すべてのライターは、 CVssWriter から派生したオブジェクトをインスタンス化する必要があります。
CVssWriter から派生したオブジェクトは、すべての CSVsWriter の純粋な仮想メソッドの実装を提供する必要があります。
ライターは、1 つまたはすべての CSVsWriter の仮想メソッドをオーバーライドできます。
VSS に参加するには、ライターが最初に CVssWriter::Initialize を呼び出してから、 CVssWriter::Subscribe を呼び出す必要があります。
ライターは、 CVssWriter::Unsubscribe を呼び出して参加を終了します。
CVssWriter 基底クラスは、イベント ハンドラーに渡されるインターフェイスのライフ サイクルを担当します。 次に例を示します。
- 渡される IVssWriterComponents インターフェイスの インスタンス: CVssWriter::OnPrepareBackup
- CVssWriter::OnIdentify に渡される IVssCreateWriterMetadata インターフェイスのインスタンス。
メソッド
CVssWriter クラスには、これらのメソッドがあります。
CVssWriter::~CVssWriter ~CVssWriter は、CVssWriter クラス オブジェクトのデストラクターです。 |
CVssWriter::AreComponentsSelected AreComponentsSelected メソッドは、リクエスターがコンポーネント モードで実行されているかどうかを示し、バックアップする個々のコンポーネントの選択をサポートするか、ボリューム全体をバックアップするかを示します。 |
CVssWriter::CVssWriter CVssWriter は、CVssWriter クラス オブジェクトのコンストラクターです。 |
CVssWriter::GetBackupType GetBackupType メソッドは、実行するバックアップの種類を示します。 |
CVssWriter::GetContext GetContext 情報は、進行中または可能なシャドウ コピーの現在のコンテキストを返します。 |
CVssWriter::GetCurrentLevel GetCurrentLevel メソッドは、現在のアプリケーション レベルを返します。 |
CVssWriter::GetCurrentSnapshotSetId GetCurrentSnapshotSetId メソッドは、シャドウ コピー セットの一意識別子を返します。 |
CVssWriter::GetCurrentVolumeArray GetCurrentVolumeArray メソッドは、元のボリュームの名前と、シャドウ コピー セットに属する元のリモート ファイル共有の UNC パスを、null で終わるワイド文字列の配列として返します。Windows 7、Windows Server 2008 R2、Windows Vista、Windows Server 2008、Windows XP、Windows Server 2003: リモート ファイル共有は、Windows 8およびWindows Server 2012するまでサポートされません。 |
CVssWriter::GetCurrentVolumeCount GetCurrentVolumeCount メソッドは、シャドウ コピー セット内のボリュームの数を返します。 |
CVssWriter::GetRestoreType GetRestoreType メソッドは、ライターが参加している復元の種類を返します。 |
CVssWriter::GetSnapshotDeviceName GetSnapshotDeviceName メソッドは、指定したボリュームまたはファイル共有のシャドウ コピーをホストするデバイスの名前を返します。 |
CVssWriter::Initialize CVssWriter オブジェクトを初期化し、ライター アプリケーションが VSS と対話できるようにします。 |
CVssWriter::InstallAlternateWriter サポートされていません。 (CVssWriter.InstallAlternateWriter) |
CVssWriter::IsBootableSystemStateBackedUp IsBootableSystemStateBackedUp メソッドは、起動可能な状態をバックアップするかどうかを示します。 |
CVssWriter::IsPartialFileSupportEnabled IsPartialFileSupportEnabled メソッドは、部分ファイルのサポートを有効にするか無効にするかを決定します。 |
CVssWriter::IsPathAffected IsPathAffected メソッドは、指定したディレクトリまたはファイルを現在のシャドウ コピー セットに含めるかどうかを決定します。 ディレクトリまたはファイルのパスには、ローカル パスまたはリモート ファイル共有の UNC パスを指定できます。 |
CVssWriter::OnAbort OnAbort メソッドは、シャドウ コピー操作が途中で終了したことを示す VSS によって発行された Abort イベントの後にライターによって呼び出されます。 ライターは、このメソッドを使用して、その操作への参加の試行からクリーンします。 |
CVssWriter::OnBackOffIOOnVolume サポートされていません。 (CVssWriter.OnBackOffIOOnVolume) |
CVssWriter::OnBackupComplete OnBackupComplete メソッドは、BackupComplete イベントの後にライターによって呼び出されます。 これは、バックアップの後に必要と見なされる操作を実行するために使用されます。 ただし、これらの操作でバックアップ コンポーネント ドキュメントを変更することはできません。 |
CVssWriter::OnBackupShutdown OnBackupShutdown メソッドは、BackupShutdown イベントの後にライターによって呼び出されます。 これは、特にバックアップ アプリケーションがクラッシュした場合に、バックアップ アプリケーションがシャットダウンしたときに必要と見なされる操作を実行するために使用されます。 |
CVssWriter::OnContinueIOOnVolume サポートされていません。 (CVssWriter.OnContinueIOOnVolume) |
CVssWriter::OnFreeze OnFreeze メソッドは、シャドウ コピーのフリーズの開始時に Freeze イベントを受信すると、ライターによって呼び出されます。 ライターは、このメソッドを使用して、フリーズに参加したり、フリーズを拒否したりするために必要な操作を実行します。 |
CVssWriter::OnIdentify OnIdentify メソッドは、Identify イベントの受信後にライターによって呼び出されます。 |
CVssWriter::OnPostRestore OnPostRestore メソッドは、PostRestore イベントの後にライターによって呼び出されます。 これは、リクエスターによってファイルがディスクに復元された後に、必要と見なされる操作を実行するために使用されます。 ただし、これらの操作でバックアップ コンポーネント ドキュメントを変更することはできません。 |
CVssWriter::OnPostSnapshot OnPostSnapshot メソッドは、PostSnapshot イベントの後にライターによって呼び出されます。 |
CVssWriter::OnPrepareBackup OnPrepareBackup メソッドは、PrepareForBackup イベントの後にライターによって呼び出されます。 このメソッドは、バックアップ操作の準備としてライターの状態とそのコンポーネントを構成するために使用されます。 |
CVssWriter::OnPrepareSnapshot OnPrepareSnapshot メソッドは、PrepareForSnapshot イベントを処理するためにライターによって呼び出されます。 これは、シャドウ コピーに参加するライターを準備したり、シャドウ コピーを拒否したりするために必要な操作を実行するために使用されます。 |
CVssWriter::OnPreRestore OnPreRestore メソッドは、PreRestore イベントの後にライターによって呼び出されます。 |
CVssWriter::OnThaw OnThaw メソッドは、Thaw イベントの後にライターによって呼び出されます。 |
CVssWriter::OnVSSApplicationStartup サポートされていません。 (CVssWriter.OnVSSApplicationStartup) |
CVssWriter::OnVSSShutdown サポートされていません。 (CVssWriter.OnVssShutdown) |
CVssWriter::SetWriterFailure SetWriterFailure メソッドは、このライターがエラー条件を検出し、エラー条件を設定することを示します。 |
CVssWriter::Subscribe Subscribe メソッドは、ライターを VSS でサブスクライブします。 |
CVssWriter::Unsubscribe Unsubscribe メソッドは、VSS を使用してライターの登録を解除します。 |
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | vswriter.h (Vss.h、VsWriter.h を含む) |