Метод IVssDifferentialSoftwareSnapshotMgmt::ChangeDiffAreaMaximumSize (vsmgmt.h)

  • Статья

Метод ChangeDiffAreaMaximumSize обновляет максимальный размер области хранения теневых копий для определенного тома. Это может не иметь немедленного эффекта.

Синтаксис

HRESULT ChangeDiffAreaMaximumSize(
  [in] VSS_PWSZ pwszVolumeName,
  [in] VSS_PWSZ pwszDiffAreaVolumeName,
  [in] LONGLONG llMaximumDiffSpace
);

Параметры

[in] pwszVolumeName

Имя тома, который является источником теневых копий. Этот том связан с областью хранилища теневого копирования на томе pwszDiffAreaVolumeName .

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

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

[in] pwszDiffAreaVolumeName

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

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

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

[in] llMaximumDiffSpace

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

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

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

Значение Значение
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
 Теневая копия в настоящее время использует область хранения теневого копирования.

Комментарии

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

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

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

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

Требования

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

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

IVssDifferentialSoftwareSnapshotMgmt