Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Reset method of the MSFT_PhysicalDisk class

Resets the health and operational status of the physical disk.

Syntax


UInt32 Reset(
  [out]  String ExtendedStatus
);

Parameters

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)
Access denied (40001)
There are not enough resources to complete the operation. (40002)
Cannot connect to the storage provider. (46000)
The storage provider cannot connect to the storage subsystem. (46001)
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)

Remarks

The exact behavior of this method depends on whether this physical disk belongs to a concrete pool.

If it is a member of a concrete pool, the HealthStatus property should be set to Healthy, and the OperationalStatus property should be set to OK. If any additional errors are detected after Reset, the health and operational statuses should reflect these new errors.

If the physical disk is not a member of a concrete pool, then this method should not only reset the health and operational statuses, but it should return the disk into a state where it is usable as storage for a concrete pool. For example, if a physical disk is missing and then reappears (after it has been replaced), this physical disk is expected to be in the primordial pool only with an operational status indicating its data is either split or corrupt. Calling Reset should clear the physical disk of any data, remove any remaining ties to its former concrete pool, and return the disk to a healthy, usable state.

Requirements

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

See also

MSFT_PhysicalDisk

 

 

Community Additions

Show:
© 2014 Microsoft