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

Статья
03/08/2023

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

Share via