IVdsLun interface

[Beginning with Windows 8 and Windows Server 2012, the Virtual Disk Service COM interface is superseded by the Windows Storage Management API.]

Provides methods for performing query and configuration operations on a logical unit number (LUN).

When to implement

Hardware providers implement this interface in their LUN object.

When to use

Applications call the methods on this interface to perform query operations on a LUN. This includes retrieving the subsystem to which the LUN belongs and retrieving the active controllers and plexes. Other query operations include getting LUN properties, LUN identification data, and LUN automagic configuration hints. These methods also enable applications to perform configuration operations including extending and shrinking a LUN, adding and removing plexes, changing LUN masking, and applying hints. Other methods provide for recovering a LUN, setting LUN status, and deleting a LUN.

Members

The IVdsLun interface inherits from the IUnknown interface. IVdsLun also has these types of members:

Methods

The IVdsLun interface has these methods.

MethodDescription
AddPlex

Adds a LUN to the target LUN as a new plex.

(Inherited from IVdsLun)
ApplyHints

Applies a new set of hints to the LUN.

(Inherited from IVdsLun)
AssociateControllers

Sets the subsystem controllers to active or inactive with respect to the LUN.

(Inherited from IVdsLun)
Delete

Deletes the LUN and all of its plexes.

(Inherited from IVdsLun)
Extend

Extends a LUN by a specified number of bytes. The caller can specify a list of drives for the provider to use for extending the LUN, or direct the provider to select the drives automatically.

(Inherited from IVdsLun)
GetIdentificationData

Returns the LUN identification data, which comprises fields from the SCSI Inquiry Data and Vital Product Data pages 0x80 and 0x83.

(Inherited from IVdsLun)
GetProperties

Returns the LUN properties.

(Inherited from IVdsLun)
GetSubSystem

Returns the subsystem that surfaces the LUN.

(Inherited from IVdsLun)
QueryActiveControllers

Returns an enumeration of the currently active controllers—the controllers through which the LUN is accessible.

(Inherited from IVdsLun)
QueryHints

Returns the hints currently applied to the LUN.

(Inherited from IVdsLun)
QueryMaxLunExtendSize

Returns the maximum size by which a LUN can be extended.

(Inherited from IVdsLun)
QueryPlexes

Returns an enumeration of the LUN plexes. All LUNs have at least one plex.

(Inherited from IVdsLun)
Recover

Starts a recovery operation on a LUN.

(Inherited from IVdsLun)
RemovePlex

Removes a plex from a LUN.

(Inherited from IVdsLun)
SetMask

Specifies the LUN unmasking list—the list of computers on the network to be granted access to the LUN.

(Inherited from IVdsLun)
SetStatus

Sets the LUN status to the specified value.

(Inherited from IVdsLun)
Shrink

Shrinks a LUN by a specified number of bytes.

(Inherited from IVdsLun)

 

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Vds.h;
VdsHwPrv.h (for hardware providers)

Library

Uuid.lib

See also

VDS Interfaces
IVdsLunPlex::GetLun
LUN Object

 

 

Show: