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


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

[Начиная с 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

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

IVdsDisk

IVdsDisk::ClearFlags

IVdsDisk::ConvertStyle

IVdsDisk::GetIdentificationData

IVdsDisk::GetPack

IVdsDisk::GetProperties

IVdsDisk::SetFlags

VDS_DISK_EXTENT