次の方法で共有


IVssBackupComponents::InitializeForBackup メソッド (vsbackup.h)

InitializeForBackup メソッドは、バックアップの準備としてバックアップ コンポーネントのメタデータを初期化します。

構文

HRESULT InitializeForBackup(
  [in] BSTR bstrXML
);

パラメーター

[in] bstrXML

任意。 転送されたシャドウ コピーのインポート時に、このパラメーターは、保存されたシャドウ コピーを作成するときに生成され、 IVssBackupComponents::SaveAsXML を使用して保存された元のドキュメントである必要があります。

戻り値

このメソッドの有効なリターン コードを次に示します。

意味
S_OK
指定したドキュメントをバックアップ用に正常に初期化しました。
E_ACCESSDENIED
呼び出し元が十分なバックアップ特権を持っていないか、管理者ではありません。
E_OUTOFMEMORY
呼び出し元がメモリやその他のシステム リソースを使い切れている。
VSS_E_BAD_STATE
バックアップ コンポーネント オブジェクトが初期化されていないか、復元操作中にこのメソッドが呼び出されたか、このメソッドが正しいシーケンス内で呼び出されていません。
VSS_E_INVALID_XML_DOCUMENT
XML ドキュメントが無効です。 詳細については、イベント ログを確認してください。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。
VSS_E_UNEXPECTED
予期しないエラー。 エラー コードは、エラー ログ ファイルに記録されます。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。

Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 R2 と Windows 7 まではサポートされません。 代わりに E_UNEXPECTED が使用されます。

注釈

このメソッドに指定された XML ドキュメントは、 IVssBackupComponents ::SaveAsXML の呼び出しによって以前に格納されたメタデータを使用して 、IVssBackupComponents オブジェクトを初期化します。 ユーザーはこのメタデータ ドキュメントを改ざんしないでください。

転送可能なシャドウ コピーで InitializeForBackup を使用する方法の詳細については、「 トランスポート可能なシャドウ コピー ボリュームのインポート」を参照してください。

要件

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

こちらもご覧ください

IVssBackupComponents

IVssBackupComponents::SaveAsXML