IVssDifferentialSoftwareSnapshotMgmt::AddDiffArea メソッド (vsmgmt.h)
AddDiffArea メソッドは、指定されたボリュームのシャドウ コピー記憶域の関連付けを追加します。 関連付けがサポートされていない場合は、エラー コードが返されます。
構文
HRESULT AddDiffArea(
[in] VSS_PWSZ pwszVolumeName,
[in] VSS_PWSZ pwszDiffAreaVolumeName,
[in] LONGLONG llMaximumDiffSpace
);
パラメーター
[in] pwszVolumeName
シャドウ コピーのソースとなるボリュームの名前。 このボリュームは、 pwszDiffAreaVolumeName ボリューム上のシャドウ コピー記憶域に関連付けられています。
ボリュームの名前は、次のいずれかの形式である必要があり、末尾に円記号 (\) を含める必要があります。
- マウントされたフォルダーのパス (Y:\MountX\ など)
- ドライブ文字 (D:\ など)
- \\?\Volume{GUID}\ という形式のボリューム GUID パス ( GUID はボリュームを識別します)
[in] pwszDiffAreaVolumeName
pwszVolumeName ボリュームに関連付けるシャドウ コピー記憶域を含むボリュームの名前。
ボリュームの名前は、次のいずれかの形式である必要があり、末尾に円記号 (\) を含める必要があります。
- マウントされたフォルダーのパス
- ドライブ文字 (D:\ など)
- \\?\Volume{GUID}\ という形式のボリューム GUID パス ( GUID はボリュームを識別します)
[in] llMaximumDiffSpace
ボリューム上のシャドウ コピー記憶域の最大サイズ (バイト単位)。 この値は、システム全体の制限まで、少なくとも 320 MB である必要があります。 この値が –1 の場合、最大サイズは無制限です。
Windows Server 2003: WINDOWS Server 2003 SP1 より前のバージョンでは、シャドウ コピーの記憶域サイズは 100 MB で固定されていました。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| 値 | 意味 |
|---|---|
|
シャドウ コピー記憶域の関連付けが正常に追加されました。 |
|
呼び出し元に十分なバックアップ特権がないか、管理者ではありません。 |
|
パラメーター値の 1 つが無効です。 |
|
呼び出し元がメモリやその他のシステム リソースを使い切れている。 |
|
シャドウ コピー の記憶域領域の最大数がシャドウ コピー ソース ボリュームに追加されました。 指定したシャドウ コピー ストレージ ボリュームが、指定したシャドウ コピー ソース ボリュームに関連付けされませんでした。 |
|
指定されたボリュームが深すぎて VSS 操作に参加できません。
Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: このリターン コードはサポートされていません。 |
|
pwszVolumeName ボリュームと pwszDiffAreaVolumeName ボリュームの間の関連付けは既に存在します。 |
|
プロバイダー エラーが予想されます。 プロバイダーがイベント ログにエラーを記録しました。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。 |
|
予期しないエラー。 エラー コードは、エラー ログ ファイルに記録されます。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。
Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 R2 と Windows 7 まではサポートされません。 代わりに E_UNEXPECTED が使用されます。 |
|
pwszDiffAreaVolumeName ボリュームが NTFS ボリュームではないか、空き領域が不足しています。 |
注釈
pwszVolumeName ボリュームにシャドウ コピーが既に存在する場合、またはそのボリュームにシャドウ コピー記憶域の関連付けが既にある場合は、シャドウ コピー記憶域の関連付けを作成できません。
仮想ハード ディスク (VHD) ソース ボリュームのシャドウ コピー記憶域は、同じボリューム上に存在する必要があります。 同様に、シャドウ コピー記憶域は、ソース ボリュームが両方のボリュームで同じ場合にのみ VHD ボリュームに作成できます。
Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: VHD はサポートされていません。
シャドウ コピー記憶域のサイズを変更するには、 IVssDifferentialSoftwareSnapshotMgmt::ChangeDiffAreaMaximumSize または IVssDifferentialSoftwareSnapshotMgmt2::ChangeDiffAreaMaximumSizeEx メソッドを使用します。 シャドウ コピーの記憶域を削除するには、そのサイズを 0 に変更します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | vsmgmt.h |