CreateOrModifyStoragePool method of the MSISCSITARGET_StorageConfigurationService class

Creates or modifies a MSISCSITARGET_StoragePool instance, or starts a job to do so. This method can only create or modify a storage pool instance in the same system scope as this MSISCSITARGET_StorageConfigurationService instance.

This method is inherited from the CIM_StorageConfigurationService class.

Syntax

uint32 CreateOrModifyStoragePool(
  [in]      string                 ElementName,
  [out]     CIM_ConcreteJob Ref    Job,
  [in]      CIM_StorageSetting Ref Goal,
  [in, out] uint64                 Size,
  [in]      string                 InPools[],
  [in]      string                 InExtents[],
  [in, out] CIM_StoragePool Ref    Pool
);

Parameters

ElementName [in]

Specifies an end-user relevant name for the pool to be created. The value is propagated to the ElementName property of the created pool. If NULL, a system-supplied default name is used.

If not NULL when modifying an existing pool, specifies a new name for the modified pool.

Job [out]

On return, contains a reference to the job, if a job is created and not completed.

Goal [in]

Specifies the characteristics, qualities of service, and goals for the element to maintain. If NULL, the default configuration from the source pool is used.

If not NULL when modifying an existing element, specifies a new goal for the modified element.

Size [in, out]

On input, specifies the wanted size in bytes. If not NULL when modifying an existing element, specifies a new size.

On output, indicates the actual size created.

InPools [in]

Specifies, in the form of string representations, the component MSISCSITARGET_StoragePool instances that are used to compose the resulting MSISCSITARGET_StoragePool instance.

InExtents [in]

Specifies, in the form of string representations, the component CIM_StorageExtent instances that are used to compose the resulting MSISCSITARGET_StoragePool instance.

Pool [in, out]

On input, specifies a MSISCSITARGET_StoragePool instance to modify, or if NULL, specifies to create a new instance.

On output, contains a reference to the created or modified storage pool.

Return value

This method returns one of the following values.

Job Completed with No Error (0)

Not Supported (1)

Unknown (2)

Timeout (3)

Failed (4)

Invalid Parameter (5)

In Use (6)

DMTF Reserved (7 4095)

Method Parameters Checked - Job Started (4096)

Size Not Supported (4097)

Method Reserved (4098 32767)

Vendor Specific (32768 65535)

Requirements

See also

MSISCSITARGET_StorageConfigurationService