AddPhysicalDisk method of the MSFT_StoragePool class
Adds one or more physical disks from the primordial storage pool to an existing concrete storage pool.
Syntax
UInt32 AddPhysicalDisk(
[in] String PhysicalDisks[],
[in] UInt16 Usage,
[in] Boolean RunAsJob,
[out] MSFT_StorageJob REF CreatedStorageJob,
[out] String ExtendedStatus
);
Parameters
PhysicalDisks [in]
An array of strings, each of which contains an embedded MSFT_PhysicalDisk instance that represents a physical disk to be added from the primordial storage pool to an existing concrete storage pool. This parameter is required and cannot be NULL.
Usage [in]
Specifies how the physical disks will be used in the storage pool s allocation policy. Storage pools are required to follow the assigned policy for a physical disk.
Auto-Select (1)
Manual-Select (2)
Hot Spare (3)
RunAsJob [in]
If TRUE, this method uses the CreatedStorageJob parameter when the request is taking a long time to service. If a storage job has been created to track the operation, this method will return Method Parameters Checked - Job Started.
Note
Even if RunAsJob is TRUE, this method can still return a result if it has finished in sufficient time.
If FALSE or NULL, this method will follow default WMI asynchronous behavior as determined by the client's method for invocation. In other words, it is synchronous unless requested otherwise.
CreatedStorageJob [out]
If RunAsJob is set to TRUE and this method takes a long time to execute, this parameter receives a reference to the storage job object that is used to track the long-running operation.
ExtendedStatus [out]
A string that contains an embedded MSFT_StorageExtendedStatus object.
This parameter allows the storage provider to return extended (implementation-specific) error information.
Return value
Success (0)
Not Supported (1)
Unspecified Error (2)
Timeout (3)
Failed (4)
Invalid Parameter (5)
Method Parameters Checked - Job Started (4096)
Access denied (40001)
There are not enough resources to complete the operation. (40002)
Cache out of date (40003)
Cannot connect to the storage provider. (46000)
The storage provider cannot connect to the storage subsystem. (46001)
This operation is not supported on primordial storage pools. (48000)
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)
One of the physical disks specified is not supported by this operation. (51000)
One of the physical disks specified is already in use. (51002)
One of the physical disks specified uses a sector size that is not supported by this storage pool. (51003)
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 8 [desktop apps only] |
| Minimum supported server | Windows Server 2012 [desktop apps only] |
| Namespace | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |