Show method of the MSFT_VirtualDisk class

Shows a virtual disk to an initiator.

This operation is also known as "exposing" or "unmasking" a virtual disk.

Syntax

UInt32 Show(
  [in]  String              TargetPortAddresses[],
  [in]  String              InitiatorAddress,
  [in]  UInt16              HostType,
  [in]  Boolean             RunAsJob,
  [out] MSFT_StorageJob REF CreatedStorageJob,
  [out] String              ExtendedStatus
);

Parameters

TargetPortAddresses [in]

An array of target port addresses from which the virtual disk should be shown.

This parameter is required and cannot be NULL.

InitiatorAddress [in]

The address of the initiator to which the virtual disk should be shown.

This parameter is required and cannot be NULL.

HostType [in]

The host operating system or other host environmental factors that may influence the behavior that the storage system should have when showing a virtual disk to an initiator.

Unknown (0)

Standard (2)

Solaris (3)

HPUX (4)

OpenVMS (5)

Tru64 (6)

Netware (7)

Sequent (8)

AIX (9)

DGUX (10)

Dynix (11)

Irix (12)

Cisco iSCSI Storage Router (13)

Linux (14)

Microsoft Windows (15)

OS400 (16)

TRESPASS (17)

HI-UX (18)

VMware ESXi (19)

Microsoft Windows Server 2008 (20)

Microsoft Windows Server 2003 (21)

DMTF Reserved (22..32767)

Vendor Specific (32768..65535)

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)

The HostType requested is not supported. (52001)

The initiator address specified is not valid (53000)

The target port address specified is not valid. (54000)

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