GetAvailableExtents method of the MSISCSITARGET_StoragePool class

Retrieves a list of available CIM_StorageExtent instances that can be used in the creation or modification of a MSISCSITARGET_StoragePool, MSISCSITARGET_StorageVolume, or CIM_LogicalDisk instance. The GetAvailableExtents method must return the extents from the set of component extents of the pool on which the method is being invoked. The returned extents are available at the time the method returns; there is no guarantee that they are available later.

Syntax

uint32 GetAvailableExtents(
  [in]  CIM_StorageSetting Ref Goal,
  [out] CIM_StorageExtent Ref  AvailableExtents[]
);

Parameters

Goal [in]

Specifies the MSISCSITARGET_StorageSetting instance that defines the qualities of service and goals, which requested extents must support.

If set to NULL this method will return all available extents, which might cause an error if an extent is used inappropriately.

AvailableExtents [out]

On return, contains a list of references to available storage extents or subclass instances.

Return value

This method returns one of the following values.

Completed with No Error (0)

Not Supported (1)

Unknown (2)

Timeout (3)

Failed (4)

Invalid Parameter (5)

In Use (6)

DMTF Reserved (7 4097)

Method Reserved (4098 32767)

Vendor Specific (32768 65535)

Requirements

See also

MSISCSITARGET_StoragePool