Метод IVdsDisk::QueryExtents (vds.h)

Статья
03/08/2023

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

Возвращает сведения обо всех экстентах на диске.

Синтаксис

HRESULT QueryExtents(
  [out] VDS_DISK_EXTENT **ppExtentArray,
  [out] LONG            *plNumberOfExtents
);

Параметры

[out] ppExtentArray

Переменная указателя, получающая
массив структур VDS_DISK_EXTENT . Вызывающие элементы должны освободить этот массив с помощью функции CoTaskMemFree .

[out] plNumberOfExtents

Адрес типа LONG , представляющий общее количество экстентов.

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

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

Возвращаемый код/значение	Описание
S_OK	Сведения об экстенте были успешно возвращены.
VDS_E_PACK_OFFLINE 0x80042444L	Пакет, к которому принадлежит диск, недоступен.

Используйте этот метод для определения объема свободного пространства, доступного для создания или расширения томов. Вы также можете использовать сведения об экстенте, чтобы определить, сколько томов занимают диск. Допустимые типы экстентов: неизвестные экстенты, свободные экстенты, области данных, экстенты OEM, экстенты ESP, экстенты MSR, области метаданных LDM и непригодные для использования экстенты. Экстент данных содержит ссылку на том поверх него.

Если диск является динамическим, он должен быть подключен к сети. Если это базовый или необработанный диск, он может быть подключен к сети или в автономном режиме.

Требования

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