Share via


CreateStorageVolume method of the MSFT_SMPool class

Starts a job to create a storage volume.

Syntax

uint32 CreateStorageVolume(
  [in, optional]      string                   ElementName,
  [in, out, optional] uint64                   Size,
  [in, optional]      boolean                  UseMaximumSize,
  [in, optional]      String                   PoolSettingObjectId,
  [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, optional]

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

UseMaximumSize [in, optional]

If True, requests the provider to create a storage volume with the maximum possible size.

PoolSettingObjectId [in, optional]

The ObjectId of a pool setting the defines the service level that the storage volume is expected to provide. If NULL the storage service will try to locate a default setting.

**Windows Server 2012: **

This parameter is not supported.

NoSinglePointOfFailure [in, optional]

This parameter is not supported.

**Windows Server 2012: **

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]

This parameter is not supported.

**Windows Server 2012: **

The desired number of redundant packages to be used.

Range: 0 = value

DataRedundancyGoal [in, optional]

This parameter is not supported.

**Windows Server 2012: **

The desired number of complete copies of data to maintain.

Range: 1 = value

ParityLayout [in, optional]

This parameter is not supported.

**Windows Server 2012: **

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]

Reference to the created MSFT_SMStorageVolume.

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)

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 and UseMaximumSize input parameters must be mutually exclusive (40320)

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 Volume (40609)

StorageService CIM Error: Failed (43001)

StorageService CIM Error: Access denied (43002)

StorageService CIM Error: Invalid namespace (43003)

StorageService CIM Error: Invalid parameter (43004)

StorageService CIM Error: Invalid class (43005)

StorageService CIM Error: Not found (43006)

StorageService CIM Error: Not supported (43007)

StorageService CIM Error: Class has children (43008)

StorageService CIM Error: Class has instances (43009)

StorageService CIM Error: Invalid superclass (43010)

StorageService CIM Error: Already exists (43011)

StorageService CIM Error: No such property (43012)

StorageService CIM Error: Type mismatch (43013)

StorageService CIM Error: Query language not supported (43014)

StorageService CIM Error: Invalid query (43015)

StorageService CIM Error: Method not available (43016)

StorageService CIM Error: Method not found (43017)

StorageService CIM Error: Unexpected response (43018)

StorageService CIM Error: Invalid response destination (43019)

StorageService CIM Error: Namespace not empty (43020)

StorageService CIM Error: Invalid enumeration context (43021)

StorageService CIM Error: Invalid operation timeout (43022)

StorageService CIM Error: Pull has been abandoned (43023)

StorageService CIM Error: Pull cannot be abandoned (43024)

StorageService CIM Error: Filtered enumeration not supported (43025)

StorageService CIM Error: Continuation on error not supported (43026)

StorageService CIM Error: Server limits exceeded (43027)

StorageService CIM Error: Server is shutting down (43028)

StorageService CIM Error: Query feature not supported (43029)

StorageService: Generic Failure (51000)

StorageService: Invalid connection credentials (51005)

StorageService: SSL connection failure (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_SMPool