IVssDifferentialSoftwareSnapshotMgmt2::ChangeDiffAreaMaximumSizeEx メソッド (vsmgmt.h)

  • [アーティクル]

特定のボリュームのシャドウ コピー記憶域の最大サイズを更新します。 これはすぐには効果がない可能性があります。 bVolatile パラメーターが FALSE の場合、コンピューターが再起動された場合でも変更は続行されます。

構文

HRESULT ChangeDiffAreaMaximumSizeEx(
  [in] VSS_PWSZ pwszVolumeName,
  [in] VSS_PWSZ pwszDiffAreaVolumeName,
  [in] LONGLONG llMaximumDiffSpace,
  [in] BOOL     bVolatile
);

パラメーター

[in] pwszVolumeName

シャドウ コピーのソースであるボリュームの名前。 このボリュームは、 pwszDiffAreaVolumeName ボリューム上のシャドウ コピー記憶域に関連付けられています。

ボリュームの名前は、次のいずれかの形式である必要があり、末尾に円記号 (\) を含める必要があります。

  • マウントされたフォルダーのパス (Y:\MountX\ など)
  • ドライブ文字 (D:\ など)
  • \\?\Volume{GUID}\ という形式のボリューム GUID パス ( GUID はボリュームを識別します)

[in] pwszDiffAreaVolumeName

pwszVolumeName ボリュームに関連付けられているシャドウ コピー記憶域を含むボリュームの名前。

ボリュームの名前は、次のいずれかの形式である必要があり、末尾に円記号 (\) を含める必要があります。

  • マウントされたフォルダーのパス
  • D:\ などのドライブ文字
  • \\?\Volume{GUID}\ という形式のボリューム GUID パス ( GUID はボリュームを識別します)

[in] llMaximumDiffSpace

ボリュームに使用するシャドウ コピー記憶域の最大サイズをバイト単位で指定します。 この値が 0 の場合、シャドウ コピーの記憶域は削除されます。 この値が –1 の場合、最大サイズは無制限です。

[in] bVolatile

コンピューターが再起動された場合に ChangeDiffAreaMaximumSizeEx メソッドを呼び出す効果を続行しないことを示す場合は TRUE。それ以外の場合は FALSE。

既定値は FALSE です。

llMaximumDiffSpace パラメーターが 0 の場合、bVolatile パラメーターは FALSE である必要があります。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

値 意味
S_OK
 シャドウ コピーの記憶域の最大サイズが正常に変更されました。
E_ACCESSDENIED
 呼び出し元が十分なバックアップ特権を持っていないか、管理者ではありません。
E_INVALIDARG
 パラメーター値の 1 つが無効です。
E_OUTOFMEMORY
 呼び出し元がメモリやその他のシステム リソースを使い切れている。
VSS_E_INSUFFICIENT_STORAGE
 pwszDiffAreaVolumeName ボリュームに十分な空き領域がありません。
VSS_E_OBJECT_NOT_FOUND
 pwszVolumeName ボリュームと pwszDiffAreaVolumeName ボリュームの間の関連付けが見つかりませんでした。
VSS_E_PROVIDER_VETO
 予想されるプロバイダー エラーが発生しました。 エラー コードはイベント ログに記録されます。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。
VSS_E_UNEXPECTED
 予期しないエラー。 エラー コードは、エラー ログ ファイルに記録されます。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。

Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 R2 と Windows 7 まではサポートされません。 代わりに E_UNEXPECTED が使用されます。
VSS_E_VOLUME_IN_USE
 シャドウ コピーは現在、シャドウ コピーの記憶域を使用しています。

注釈

ChangeDiffAreaMaximumSizeEx メソッドは、bVolatile パラメーターを除き、IVssDifferentialSoftwareSnapshotMgmt::ChangeDiffAreaMaximumSize メソッドと同じです。

bVolatile パラメーターを FALSE に設定して ChangeDiffAreaMaximumSizeEx メソッドを呼び出すことは、ChangeDiffAreaMaximumSize メソッドの呼び出しと同じです。

ChangeDiffAreaMaximumSizeEx は、シャドウ コピー記憶域を明示的にします。つまり、すべてのシャドウ コピーが削除されると自動的に削除されません。

シャドウ コピー記憶域が存在しない場合は、このメソッドによって作成されます。

Windows Server 2008、Windows Vista、Windows Server 2003: シャドウ コピー記憶域が存在しない場合、このメソッドでは作成されません。

シャドウ コピー記憶域を作成するには、 IVssDifferentialSoftwareSnapshotMgmt::AddDiffArea メソッドを使用します。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー vsmgmt.h

こちらもご覧ください

IVssDifferentialSoftwareSnapshotMgmt2

IVssDifferentialSoftwareSnapshotMgmt::ChangeDiffAreaMaximumSize