CreateStorageVolume method of the MSFT_SMSystem class

Start a job to create a storage volume.

Syntax

uint32 CreateStorageVolume(
  [in, optional]  string                   ElementName,
  [in, out]       uint64                   Size,
  [in, optional]  boolean                  NoSinglePointOfFailure,
  [in, optional]  uint16                   PackageRedundancyGoal,
  [in, optional]  uint16                   DataRedundancyGoal,
  [in, optional]  uint16                   ParityLayout,
  [in, optional]  boolean                  ThinlyProvisioned,
  [in, optional]  String                   username,
  [in, optional]  String                   password,
  [out, optional] MSFT_SMStorageVolume REF CreatedStorageVolume,
  [out]           MSFT_SMJob           REF Job,
  [out, optional] MSFT_SMExtendedStatus    ExtendedStatus
);

Parameters

ElementName [in, optional]

End-user relevant name for the storage volume. If NULL, then a system supplied name is used.

Size [in, out]

As an input parameter, the desired size. As an output parameter, the size achieved.

NoSinglePointOfFailure [in, optional]

Whether to specify no single point of failure.

True specifies no single point of failure; False specifies a single point of failure.

PackageRedundancyGoal [in, optional]

The desired number of redundant packages to be used.

Range: 0 = value

DataRedundancyGoal [in, optional]

The desired number of complete copies of data to maintain.

Range: 1 = value

ParityLayout [in, optional]

Whether a parity-based storage organization is using rotated or non-rotated parity.

The possible values are.

Non-rotated Parity (1)

Rotated Parity (2)

ThinlyProvisioned [in, optional]

If True, the created storage volume is thinly provisioned.

username [in, optional]

Used to authenticate with the SMI-S provider. If not provided, the storage service attempts to obtain these credentials from the configuration provider.

password [in, optional]

Used to authenticate with the SMI-S provider. If not provided, the storage service attempts to obtain these credentials from the configuration provider.

CreatedStorageVolume [out, optional]

A reference to the created MSFT_SMStorageVolume instance.

Job [out]

Reference to the MSFT_SMJob instance. May be NULL if the job is completed.

ExtendedStatus [out, optional]

An MSFT_SMExtendedStatus object containing the results of calling this method.

Return value

Success

0

Not Supported

1

Unspecified Error

2

Timeout

3

Failed

4

Invalid Parameter

5

In Use

6

Windows Server 2012 R2 and Windows Server 2012: This value is unavailable prior to Windows Server 2016.

Method Parameters Checked - Job Started

4096

Size Not Supported

4097

StorageService: Method invocation failed

40300

StorageService: Cannot modify volume instance

40304

StorageService: Volume creation capability not supported

40308

StorageService: Cannot find pool

40315

StorageService: Pool does not support creation of thinly provisioned StorageVolumes

40319

StorageService: Size cannot be zero

40321

StorageService: Pool is Primordial

40600

StorageService: Pool Usage is restricted or reserved

40601

StorageService: Goal Paramters within range - failed to create storage settings on provider

40602

StorageService: Goal Paramteres within range - failed to modify storage settings on provider

40603

StorageService: NoSinglePointOfFailure desired value is not supported on provider

40604

StorageService: Invalid Paramter - PackageRedundancyGoal out of range

40605

StorageService: Invalid Paramter - DataRedundancyGoal out of range

40606

StorageService: Invalid Parameter - ParityLayout out of range

40607

StorageService: Failed - Calling GetSupportedParityLayouts on provider

40608

StorageService: Unable to find a Storage Pool to create the Storage VolumeStorageService CIM Error: Failed

40609

StorageService CIM Error: Access denied

43001

StorageService CIM Error: Invalid namespace

43002

StorageService CIM Error: Invalid parameter

43003

StorageService CIM Error: Invalid class

43004

StorageService CIM Error: Not found

43005

StorageService CIM Error: Not supported

43006

StorageService CIM Error: Class has children

43007

StorageService CIM Error: Class has instances

43008

StorageService CIM Error: Invalid superclass

43009

StorageService CIM Error: Already exists

43010

StorageService CIM Error: No such property

43011

StorageService CIM Error: Type mismatch

43012

StorageService CIM Error: Query language not supported

43013

StorageService CIM Error: Invalid query

43014

StorageService CIM Error: Method not available

43015

StorageService CIM Error: Method not found

43016

StorageService CIM Error: Unexpected response

43017

StorageService CIM Error: Invalid response destination

43018

StorageService CIM Error: Namespace not empty

43019

StorageService CIM Error: Invalid enumeration context

43020

StorageService CIM Error: Invalid operation timeout

43021

StorageService CIM Error: Pull has been abandoned

43022

StorageService CIM Error: Pull cannot be abandoned

43023

StorageService CIM Error: Filtered enumeration not supported

43024

StorageService CIM Error: Continuation on error not supported

43025

StorageService CIM Error: Server limits exceeded

43026

StorageService CIM Error: Server is shutting down

43027

StorageService CIM Error: Query feature not supported

43028

StorageService: Generic Failure

43029

StorageService: Invalid connection credentials

51000

StorageService: SSL connection failure

51005

51010

Requirements

Minimum supported client	None supported
Minimum supported server	Windows Server 2012
Namespace	Root\Microsoft\Windows\Storage\SM
MOF	MsftStrgMan.mof
DLL	StorageService.dll

See also

MSFT_SMSystem