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


Метод IVdsVolumeShrink::QueryMaxReclaimableBytes (vds.h)

[Начиная с Windows 8 и Windows Server 2012 COM-интерфейс службы виртуальных дисков замечается API управления хранилищем Windows.]

Извлекает максимальное количество байтов, которые можно восстановить из текущего тома.

Синтаксис

HRESULT QueryMaxReclaimableBytes(
  [out] ULONGLONG *pullMaxNumberOfReclaimableBytes
);

Параметры

[out] pullMaxNumberOfReclaimableBytes

Указатель на переменную, которая после успешного завершения получает максимальное количество байтов, которое может быть извлечено из текущего тома. Это число всегда будет кратно размеру кластера файловой системы, что, в свою очередь, кратно размеру сектора диска. Этот параметр является обязательным и не может иметь значение NULL.

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

Этот метод может возвращать стандартные значения HRESULT, такие как E_INVALIDARG или E_OUTOFMEMORY, а также возвращаемые значения VDS. Он также может возвращать преобразованные коды системных ошибок с помощью макроса HRESULT_FROM_WIN32 . Ошибки могут возникать из самого VDS или из используемого базового поставщика VDS . Возможные возвращаемые значения включают следующие.

Возвращаемый код или значение Описание
S_OK
Метод завершился успешно.
VDS_E_CANNOT_SHRINK
0x8004251EL
Невозможно сжать том, так как файловая система не поддерживает его.
VDS_E_DISK_REMOVEABLE
0x8004255AL
Операция не поддерживается на съемных носителях.
RPX_X_NULL_REF_POINTER
0x800706F4
Параметр pullMaxNumberOfReclaimableBytes на входных данных имеет значение NULL.

Комментарии

Этот метод может возвращать больше возвращаемых байтов, чем доступно на самом деле.

Требования

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

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

IVdsVolumeShrink