Поделиться через

Метод 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:\
  • Путь GUID тома в формате \\?\Volume{GUID}\ (где GUID идентифицирует том)

[in] pwszDiffAreaVolumeName

Имя тома, содержащего область хранения теневого копирования, связанную с томом pwszVolumeName .

Имя тома должно иметь один из следующих форматов и включать в себя обратную косую черту в конце (\):

  • Путь к подключенной папке
  • Буква диска, например D:\
  • Путь GUID тома в формате \\?\Volume{GUID}\ (где GUID идентифицирует том)

[in] llMaximumDiffSpace

Указывает максимальный размер (в байтах) для области хранения теневого копирования, используемой для тома. Если это значение равно нулю, область хранения теневых копий будет удалена. Если это значение равно –1, максимальный размер не ограничен.

[in] bVolatile

Значение TRUE указывает, что результат вызова метода ChangeDiffAreaMaximumSizeEx не должен продолжаться, если компьютер перезагружен; в противном случае — FALSE.

Значение по умолчанию — FALSE.

Если параметр llMaximumDiffSpace равен нулю, параметр bVolatile должен иметь значение FALSE.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Значение Значение
S_OK
 Максимальный размер зоны хранения теневого копирования успешно изменен.
E_ACCESSDENIED
 Вызывающий объект не имеет достаточных прав на резервное копирование или не является администратором.
E_INVALIDARG
 Одно из значений параметра недопустимо.
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 идентичен методу IVssDifferentialSoftwareSnapshotMgmt::ChangeDiffAreaMaximumSize , за исключением параметра bVolatile .

Вызов метода ChangeDiffAreaMaximumSizeEx с параметром bVolatile , равным FALSE , совпадает с вызовом метода ChangeDiffAreaMaximumSize .

ChangeDiffAreaMaximumSizeEx делает область хранения теневых копий явной, что означает, что она не удаляется автоматически при удалении всех теневых копий.

Если область хранения теневого копирования не существует, этот метод создает ее.

Windows Server 2008, Windows Vista и Windows Server 2003: Если область хранения теневого копирования не существует, этот метод не создает ее.

Чтобы создать хранилище теневых копий, используйте метод IVssDifferentialSoftwareSnapshotMgmt::AddDiffArea .

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header vsmgmt.h

См. также раздел

IVssDifferentialSoftwareSnapshotMgmt2

IVssDifferentialSoftwareSnapshotMgmt::ChangeDiffAreaMaximumSize