IVssDifferentialSoftwareSnapshotMgmt::ChangeDiffAreaMaximumSize メソッド (vsmgmt.h)

  • [アーティクル]

ChangeDiffAreaMaximumSize メソッドは、特定のボリュームのシャドウ コピー記憶域の最大サイズを更新します。 これはすぐには効果がない可能性があります。

構文

HRESULT ChangeDiffAreaMaximumSize(
  [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

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

戻り値

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

値 意味
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
 シャドウ コピーは現在、シャドウ コピーストレージ領域を使用しています。

注釈

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

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

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

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

要件

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

こちらもご覧ください

IVssDifferentialSoftwareSnapshotMgmt