Метод CreateVolume класса MSFT_StoragePool
Создает виртуальный диск и один том, используя ресурсы пула носителей.
Синтаксис
UInt32 CreateVolume(
[in] String FriendlyName,
[in] UInt64 Size,
[in] String StorageTiers[],
[in] UInt64 StorageTierSizes[],
[in] UInt16 ProvisioningType,
[in] String ResiliencySettingName,
[in] UInt16 PhysicalDiskRedundancy,
[in] UInt16 NumberOfColumns,
[in] UInt16 FileSystem,
[in] String AccessPath,
[in] String FileServer,
[out] String CreatedVolume,
[out] MSFT_StorageJob REF CreatedStorageJob,
[out] String ExtendedStatus
);
Параметры
FriendlyName [in]
Понятное имя тома. Понятное имя должно описывать том. Он не должен быть уникальным. Метка файловой системы также будет иметь это имя.
Этот параметр является обязательным и не может иметь значение NULL.
Размер [in]
Размер виртуального диска. Обратите внимание, что некоторые подсистемы хранения округлят размер до кратного размера единицы выделения. Размер созданного тома будет таким же, как и этот размер виртуального диска.
StorageTiers [in]
Уровни хранилища на виртуальном диске. Каждый элемент массива является объектом MSFT_StorageTier .
StorageTierSizes [in]
Размеры уровней.
ProvisioningType [in]
Тип подготовки тома.
| Значение | Значение |
|---|---|
| 1 | Тонкая подготовка — хранилище для тома выделяется по запросу. |
| 2 | Фиксированная подготовка — хранилище для тома выделяется при создании тома. |
ResiliencySettingName [in]
Имя параметра устойчивости, используемого в качестве шаблона для этого тома. Он совпадает со свойством Name экземпляра параметра устойчивости. Можно использовать только параметры устойчивости, связанные с этим пулом носителей.
PhysicalDiskRedundancy [in]
Количество сбоев физического диска, которые виртуальный диск может выдержать без потери данных. Если значение не указано, используется элемент PhysicalDiskRedundancyDefault параметра устойчивости, заданного параметром ResiliencySettingName.
NumberOfColumns [in]
Количество физических дисков, используемых для чередовки данных. Если значение не указано, используется элемент NumberOfColumnsDefault параметра устойчивости, заданного параметром ResiliencySettingName.
FileSystem [in]
Тип файловой системы, используемой на созданном томе. Файловая система CSV поддерживается только в подсистеме дисковых пространств. Для CSV пул должен быть кластеризованным, а созданный том будет общим томом кластера.
Этот параметр является обязательным и не может иметь значение NULL.
| Значение | Значение |
|---|---|
| 14 | NTFS |
| 15 | ReFS |
| 0x8000 | CSVFS_NTFS |
| 0x8001 | CSVFS_ReFS |
AccessPath [in]
Локальный путь доступа к тому. Если не удается задать путь доступа или этот параметр имеет значение NULL, будет назначен новый путь доступа.
FileServer [in]
Начиная с Windows 10: строка, содержащая внедренный объект MSFT_FileServer, представляющий файловый сервер, которому будет принадлежать этот том.
CreatedVolume [out]
Созданный том, объект MSFT_Volume .
CreatedStorageJob [out]
Возвращает ссылку на объект задания хранения, используемый для отслеживания длительной операции.
ExtendedStatus [out]
Расширенные сведения об ошибке в объекте MSFT_StorageExtendedStatus . Сведения зависят от реализации.
Возвращаемое значение
Успешно (0)
Не поддерживается (1)
Неуказаная ошибка (2)
Время ожидания (3)
Сбой (4)
Недопустимый параметр (5)
Проверенные параметры метода — задание запущено (4096)
Размер не поддерживается (4097)
Недостаточно свободного места (40000)
Доступ запрещен (40001)
Недостаточно ресурсов для завершения операции. (40002)
Произошла непредвиденная ошибка ввода-вывода. (40004)
Размер необходимо указать с помощью параметра Size или UseMaximumSize . Одновременно можно указать только один из этих параметров. (40005)
Запрошенный путь доступа уже используется. (42002)
Недопустимый путь доступа. (42007)
Указанная файловая система не поддерживается. (43001)
Том не может быть быстро отформатирован. (43002)
Не удается выполнить запрошенную операцию, если диск доступен только для чтения. (43006)
Необходимо указать имя для этого тома. (43017)
Необходимо указать файловый сервер для предоставления доступа к этому тому. (43018)
Том не предоставляется на указанном файловом сервере. (43019)
Не удается подключиться к поставщику хранилища. (46000)
Поставщик хранилища не может подключиться к подсистеме хранения. (46001)
Не удалось включить кластеризация отработки отказа для этого объекта хранилища. (46008)
Эта операция не поддерживается в первоначальных пулах носителей. (48000)
Пул носителей зарезервирован только для специального использования. (48001)
Указанный параметр устойчивости не поддерживается этим пулом носителей. (48002)
В пуле носителей недостаточно физических дисков для создания указанной конфигурации виртуального диска. (48004)
Пулу носителей не удалось завершить операцию, так как его работоспособность или состояние работы не позволяют выполнить операцию. (48006)
Пул носителей не может завершить операцию, так как его конфигурация доступна только для чтения. (48007)
Необходимо указать сведения о размере (параметр Size или UseMaximumSize ) или сведения о уровне (параметры StorageTiers и StorageTierSizes ), но не сведения о размере и уровне. (48010)
Параметр устойчивости с таким именем не существует. (49000)
Значение NoSinglePointOfFailure не поддерживается. (49001)
Значение PhysicalDiskRedundancy выходит за пределы поддерживаемого диапазона значений. (49002)
Значение NumberOfDataCopies выходит за пределы поддерживаемого диапазона значений. (49003)
Значение ParityLayout выходит за пределы поддерживаемого диапазона значений. (49004)
Значение interleave выходит за пределы поддерживаемого диапазона значений. (49005)
Значение NumberOfColumns выходит за пределы поддерживаемого диапазона значений. (49006)
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8.1 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2012 R2 [только классические приложения] |
| Пространство имен | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |