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


Метод IVdsVolume::AddPlex (vds.h)

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

Добавляет том в виде сплетения к текущему тому.

Синтаксис

HRESULT AddPlex(
  [in]  VDS_OBJECT_ID VolumeId,
  [out] IVdsAsync     **ppAsync
);

Параметры

[in] VolumeId

GUID тома, добавляемого в виде плекса.

[out] ppAsync

Адрес указателя интерфейса IVdsAsync , который VDS инициализирует при возврате. Вызывающие элементы должны освободить интерфейс. Используйте этот указатель для отмены, ожидания или запроса состояния операции.

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

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

Возвращаемый код или значение Описание
S_OK
Пул успешно добавлен.
VDS_S_GPT_BOOT_MIRRORED_TO_MBR
0x80042469L
Загрузочный том на диске GPT был зеркально отображен на диске MBR. Новый plex нельзя использовать для загрузки компьютера.
VDS_E_VOLUME_NOT_ONLINE
0x8004243DL
Том недоступен.
VDS_E_VOLUME_NOT_HEALTHY
0x8004243EL
Сбой тома или сбой.
VDS_E_VOLUME_SPANS_DISKS
0x8004243FL
Том охватывает несколько дисков.
VDS_E_REQUIRES_CONTIGUOUS_DISK_SPACE
0x80042440L
Том состоит из нескольких экстентов.
VDS_E_INVALID_OPERATION
0x80042415L
Исходный том меньше целевого тома. Если исходный том больше целевого тома, целевой том остается таким же, и операция завершается успешно.

Комментарии

Эта операция недопустима для базовых томов, которые имеют ровно один плекс.

Используйте этот метод для добавления тома в качестве плекса в другой том. Например, вызывающий объект может создать том (том B), указать том B в качестве нового плекса для существующего тома (томА A), а затем удалить том B. Новый сплетение тома А занимает те же экстенты диска, что и том B.

Примечание VDS пытается использовать одни и те же экстенты, но не может гарантировать такое поведение.
 
Вызывающие абоненты могут добавить зеркальный том в качестве нового плекса в другой том. Результирующий том содержит сплетения, равные сумме исходных томов.

Реализующие объекты должны возвращать указатель на интерфейс IVdsAsync для этого метода независимо от того, инициирует ли вызов асинхронную операцию.

Требования

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

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

IVdsAsync

IVdsVolume

Объект Volume Plex