MSFT_StoragePool 类的 CreateVolume 方法
使用存储池的资源创建虚拟磁盘和单个卷。
语法
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]
虚拟磁盘在不丢失数据的情况下可以承受的物理磁盘故障数。 如果未指定，则使用的值为 ResiliencySettingName 指定的复原设置的 PhysicalDiskRedundancyDefault 成员。
NumberOfColumns [in]
用于对数据进行条带化的物理磁盘数。 如果未指定，则使用的值为 ResiliencySettingName 指定的复原设置的 NumberOfColumnsDefault 成员。
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)
发生意外的 I/O 错误。 (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 |