Метод IVssDifferentialSoftwareSnapshotMgmt2::ChangeDiffAreaMaximumSizeEx (vsmgmt.h)

Статья
08/27/2023

Обновления максимальный размер области хранения теневого копирования для определенного тома. Это может не иметь немедленного эффекта. Если параметр 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	Теневая копия в настоящее время использует область хранения теневого копирования.

Требования

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

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

IVssDifferentialSoftwareSnapshotMgmt2

IVssDifferentialSoftwareSnapshotMgmt::ChangeDiffAreaMaximumSize

Share via