Метод 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 . Возможные возвращаемые значения включают следующие.
| Код возврата | Описание |
|---|---|
|
Метод завершился успешно. |
Комментарии
Виртуальный диск можно развернуть только в том случае, если он отсоединен.
Виртуальный диск должен быть открыт с доступом для выполнения операций с метаданными. Соответствует VIRTUAL_DISK_ACCESS_METAOPS значению перечисления VIRTUAL_DISK_ACCESS_MASK .
Требования
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Целевая платформа | Windows |
| Header | vds.h |
| Библиотека | Uuid.lib |