IVssBackupComponents::SetBackupState メソッド (vsbackup.h)
SetBackupState メソッドは、バックアップ操作の全体的な構成を定義します。
構文
HRESULT SetBackupState(
[in] bool bSelectComponents,
[in] bool bBackupBootableSystemState,
[in] VSS_BACKUP_TYPE backupType,
[in] bool bPartialFileSupport
);
パラメーター
[in] bSelectComponents
バックアップ操作または復元操作をコンポーネント モードにするかどうかを示します。
コンポーネント モードでの操作では、指定された個々のコンポーネントを選択的にバックアップすることも (除外を許可することもできます)、ボリューム上のすべてのファイルとコンポーネントのバックアップのみをサポートします。
操作がコンポーネント モードで実行される場合はブール値が true 、そうでない場合は false です 。
[in] bBackupBootableSystemState
起動可能なシステム状態のバックアップが実行されているかどうかを示します。
[in] backupType
実行 する バックアップの種類を示すVSS_BACKUP_TYPE列挙値。
[in] bPartialFileSupport
省略可能。 このパラメーターの値が true の場合、部分ファイルのサポートが有効になります。 この引数の既定値は false です。
戻り値
このメソッドの有効なリターン コードを次に示します。
値 | 意味 |
---|---|
|
バックアップの状態が正常に設定されました。 |
|
パラメーター値の 1 つが無効です。 |
|
呼び出し元がメモリやその他のシステム リソースを使い切れている。 |
|
バックアップ コンポーネント オブジェクトが初期化されていないか、復元操作中にこのメソッドが呼び出されたか、このメソッドが正しいシーケンス内で呼び出されていません。 |
|
XML ドキュメントが無効です。 詳細については、イベント ログを確認してください。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。 |
|
予期しないエラー。 エラー コードは、エラー ログ ファイルに記録されます。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。
Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 R2 と Windows 7 まではサポートされません。 代わりに E_UNEXPECTED が使用されます。 |
注釈
アプリケーションは、IVssBackupComponents::P repareForBackup を呼び出す前に SetBackupState を呼び出す必要があります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | vsbackup.h (VsBackup.h、Vss.h、VsWriter.h を含む) |
Library | VssApi.lib |