Attach method of the MSFT_VirtualDisk class

Attaches a storage spaces-based virtual disk to the system.

Syntax

UInt32 Attach(
  [in]  String StorageNodeName,
  [out] String ExtendedStatus
);

Parameters

StorageNodeName [in]

The name of the storage node.

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)

The virtual disk could not complete the operation because another computer controls its configuration. (50002)

The virtual disk could not complete the operation because its health or operational status does not permit it. (50003)

Remarks

This operation is similar to Show and Hide. However, there is no need for target and initiator configuration, because everything is done locally. Depending on the computer's NewDiskPolicy (formerly SAN policy), a storage space may need to be attached by calling this method before it can be used.

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

See also

MSFT_VirtualDisk