Share via

Метод IVdsOpenVDisk::Expand (vds.h)

  • Статья

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

Увеличивает размер виртуального диска до максимального размера, доступного на фиксированном или расширяемом диске.

Синтаксис

HRESULT Expand(
  [in]  EXPAND_VIRTUAL_DISK_FLAG Flags,
  [in]  ULONGLONG                NewSize,
  [out] IVdsAsync                **ppAsync
);

Параметры

[in] Flags

Значение перечисления EXPAND_VIRTUAL_DISK_FLAG , указывающее способ развертывания виртуального диска. Необходимо задать значение EXPAND_VIRTUAL_DISK_FLAG_NONE.

[in] NewSize

Требуемый размер развернутого виртуального диска в байтах.

[out] ppAsync

Указатель на интерфейс IVdsAsync , который после успешного завершения получает интерфейс IVdsAsync для мониторинга и управления этой операцией. Вызывающие стороны должны освободить полученный интерфейс после завершения работы с ним. Если метод IVdsAsync::Wait вызывается в интерфейсе и возвращается успешное значение HRESULT, интерфейсы, возвращаемые в структуре VDS_ASYNC_OUTPUT , должны быть освобождены путем вызова метода IUnknown::Release для каждого указателя интерфейса. Однако если функция Wait возвращает значение HRESULT сбоя или параметр pHrResultобъекта Wait получает значение HRESULT сбоя, указатели интерфейса в структуре VDS_ASYNC_OUTPUT имеют значение NULL и не должны освобождаться. Вы можете проверить наличие значений HRESULT успешного или неудачного выполнения с помощью макросов SUCCEEDED и FAILED , определенных в Winerror.h.

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

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

Код возврата Описание
S_OK
 Метод завершился успешно.

Комментарии

Виртуальный диск можно развернуть только в том случае, если он отсоединен.

Виртуальный диск должен быть открыт с доступом для выполнения операций с метаданными. Соответствует VIRTUAL_DISK_ACCESS_METAOPS значению перечисления VIRTUAL_DISK_ACCESS_MASK .

Требования

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

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

IVdsOpenVDisk