Windows hardware
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

CreateVolume method of the MSFT_StoragePool class

Creates a virtual disk and single volume using the resources of the storage pool.

Syntax


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
);

Parameters

FriendlyName [in]

The friendly name of the volume. The friendly name should describe the volume. It need not be unique. The label of the file system will also be set to this name.

This parameter is required and cannot be NULL.

Size [in]

The size of the virtual disk. Note that some storage subsystems will round the size up or down to a multiple of its allocation unit size. The size of the created volume will be as large as this virtual disk size allows.

StorageTiers [in]

The storage tiers on the virtual disk. Each array element is an MSFT_StorageTier object.

StorageTierSizes [in]

The sizes of the tiers.

ProvisioningType [in]

The provisioning type of the volume.

ValueMeaning
1

Thin provisioning - the storage for the volume is allocated on-demand.

2

Fixed provisioning - the storage for the volume is allocated when the volume is created.

 

ResiliencySettingName [in]

The name of the resiliency setting to use as a template for this the volume. It is the same as the Name property of the resiliency setting instance. Only resiliency settings associated with this storage pool may be used.

PhysicalDiskRedundancy [in]

The number of physical disk failures that the virtual disk can withstand without data loss. If not specified, the value used is the PhysicalDiskRedundancyDefault member of the resiliency setting specified by ResiliencySettingName.

NumberOfColumns [in]

The number of physical disks to use to stripe the data. If not specified, the value used is the NumberOfColumnsDefault member of the resiliency setting specified by ResiliencySettingName.

FileSystem [in]

The type of file system to use on the created volume. A CSV file system is only supported on a storage spaces subsystem. For CSV the pool must be clusterable and the volume created will be a cluster shared volume.

This parameter is required and cannot be NULL.

ValueMeaning
14

NTFS

15

ReFS

0x8000

CSVFS_NTFS

0x8001

CSVFS_ReFS

 

AccessPath [in]

A local access path to the volume. If the access path could not be set, or this parameter is NULL, a new access path will be assigned.

FileServer [in]

Starting in Windows 10: A string that contains an embedded MSFT_FileServer object, representing the file server that will own this volume.

CreatedVolume [out]

The created volume, a MSFT_Volume object.

CreatedStorageJob [out]

Returns a reference to the storage job object used to track the long-running operation.

ExtendedStatus [out]

Extended error information in a MSFT_StorageExtendedStatus object. The information is implementation-specific.

Return value

Success (0)
Not Supported (1)
Unspecified Error (2)
Timeout (3)
Failed (4)
Invalid Parameter (5)
Method Parameters Checked - Job Started (4096)
Size Not Supported (4097)
Not enough free space (40000)
Access denied (40001)
There are not enough resources to complete the operation. (40002)
An unexpected I/O error has occurred. (40004)
You must specify a size by using either the Size or the UseMaximumSize parameter. You can specify only one of these parameters at a time. (40005)
The requested access path is already in use. (42002)
The access path is not valid. (42007)
The specified file system is not supported. (43001)
The volume cannot be quick formatted. (43002)
Cannot perform the requested operation when the drive is read only. (43006)
You must specify a name for this volume. (43017)
You must specify a file server to expose this volume to. (43018)
The volume is not exposed to the specified file server. (43019)
Cannot connect to the storage provider. (46000)
The storage provider cannot connect to the storage subsystem. (46001)
Failover clustering could not be enabled for this storage object. (46008)
This operation is not supported on primordial storage pools. (48000)
The storage pool is reserved for special usage only. (48001)
The specified resiliency setting is not supported by this storage pool. (48002)
There are not enough physical disks in the storage pool to create the specified virtual disk configuration. (48004)
The storage pool could not complete the operation because its health or operational status does not permit it. (48006)
The storage pool could not complete the operation because its configuration is read-only. (48007)
You must specify the size info (either the Size or UseMaximumSize parameter) or the tier info (the StorageTiers and StorageTierSizes parameters), but not both size info and tier info. (48010)
No resiliency setting with that name exists. (49000)
The value for NoSinglePointOfFailure is not supported. (49001)
The value for PhysicalDiskRedundancy is outside of the supported range of values. (49002)
The value for NumberOfDataCopies is outside of the supported range of values. (49003)
The value for ParityLayout is outside of the supported range of values. (49004)
The value for Interleave is outside of the supported range of values. (49005)
The value for NumberOfColumns is outside of the supported range of values. (49006)

Requirements

Minimum supported client

Windows 8.1 [desktop apps only]

Minimum supported server

Windows Server 2012 R2 [desktop apps only]

Namespace

Root\Microsoft\Windows\Storage

MOF

Storagewmi.mof

See also

MSFT_StoragePool

 

 

Show:
© 2016 Microsoft