IVssBackupComponents::ImportSnapshots メソッド (vsbackup.h)
ImportSnapshots メソッドは、別のコンピューターから転送されたシャドウ コピーをインポートします。
メモ この方法は、Windows Server オペレーティング システムとボリューム シャドウ コピー サービス ハードウェア プロバイダーでのみサポートされます。
構文
HRESULT ImportSnapshots(
[out] IVssAsync **ppAsync
);
パラメーター
[out] ppAsync
インポートされたシャドウ コピーの状態データを含む IVssAsync オブジェクトへの二重間接ポインター。
戻り値
このメソッドの有効なリターン コードを次に示します。
| 値 | 意味 |
|---|---|
|
IVssAsync インターフェイスのインスタンスへのポインターが正常に返されました。 pHrResult パラメーターで返されるエラー コードについては、IVssAsync::QueryStatus のリファレンス ページを参照してください。 |
|
呼び出し元に十分なバックアップ特権がないか、管理者ではありません。 |
|
ppAsync パラメーターは、有効なポインターを指していません。つまり、NULL です。 |
|
呼び出し元がメモリ不足またはその他のシステム リソースです。 |
|
バックアップ コンポーネント オブジェクトが初期化されていないか、復元操作中にこのメソッドが呼び出されたか、このメソッドが正しいシーケンス内から呼び出されていません。 |
|
予期しないエラー。 エラー コードはエラー ログ ファイルに記録されます。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。
Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 R2 および Windows 7 まではサポートされません。 代わりに、E_UNEXPECTEDが使用されます。 |
注釈
一度にインポートできるシャドウ コピーは 1 つだけです。
要求元は、インポート シャドウ コピー操作をシリアル化する役割を担います。
呼び出し元は、 IVssAsync インターフェイスを解放する必要があります。
シャドウ コピーのインポートの詳細については、「 Importing Transportable Shadow Copied Volumes」を参照してください。
クラスター内のトランスポート可能なシャドウ コピー: クラスターでトランスポート可能なシャドウ コピーを使用する方法の詳細については、「 トランスポート可能なシャドウ コピーボリュームを使用した高速復旧」を参照してください。 元のボリュームがクラスター内にマウントされている限り、トランスポート可能なシャドウ コピーはクラスターの外部からインポートする必要があります。
メモシャドウ コピーのインポートが失敗した場合、ボリューム シャドウ コピー サービスは LUN を単独でクリーンしません。 要求者は LUN のクリーンアップを開始する必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2008、Windows Server 2003 SP1、Windows Server 2003 Datacenter、Windows Server 2003 Enterprise [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | vsbackup.h (VsBackup.h、Vss.h、VsWriter.h を含む) |
| Library | VssApi.lib |