UID

title

description

helpviewer_keywords

old-location

tech.root

ms.assetid

ms.date

ms.keywords

req.header

req.include-header

req.target-type

req.target-min-winverclnt

req.target-min-winversvr

req.kmdf-ver

req.umdf-ver

req.ddi-compliance

req.unicode-ansi

req.idl

req.max-support

req.namespace

req.assembly

req.type-library

req.lib

req.dll

req.irql

targetos

req.typenames

req.redist

ms.custom

f1_keywords

dev_langs

topic_type

api_type

api_location

api_name

NF:vds.IVdsSubSystem2.GetDrive2

IVdsSubSystem2::GetDrive2 (vds.h)

The IVdsSubSystem2::GetDrive2 method (vds.h) returns the specified drive and includes the enclosure number as a parameter.

GetDrive2

GetDrive2 method

IVdsSubSystem2 interface

GetDrive2 method

IVdsSubSystem2.GetDrive2

IVdsSubSystem2::GetDrive2

base.ivdssubsystem2_getdrive2

vds/IVdsSubSystem2::GetDrive2

vdshwprv/IVdsSubSystem2::GetDrive2

base\ivdssubsystem2_getdrive2.htm

base

5646da50-5ebd-44d8-b2e1-b3e96b9a6d3c

08/05/2022

GetDrive2, GetDrive2 method, GetDrive2 method,IVdsSubSystem2 interface, IVdsSubSystem2 interface,GetDrive2 method, IVdsSubSystem2.GetDrive2, IVdsSubSystem2::GetDrive2, base.ivdssubsystem2_getdrive2, vds/IVdsSubSystem2::GetDrive2, vdshwprv/IVdsSubSystem2::GetDrive2

vds.h

Windows

Windows 7 [desktop apps only]

Windows Server 2008 R2 [desktop apps only]

Uuid.lib

Windows

19H1

IVdsSubSystem2::GetDrive2

vds/IVdsSubSystem2::GetDrive2

c++

APIRef

kbSyntax

COM

Uuid.lib

Uuid.dll

IVdsSubSystem2.GetDrive2

IVdsSubSystem2::GetDrive2

-description

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

Returns the specified drive. This method is identical to the IVdsSubSystem::GetDrive method, except that it includes the enclosure number as a parameter.

-parameters

-param sBusNumber [in]

The number of the bus to which the drive is connected.

-param sSlotNumber [in]

The number of the slot the drive occupies.

-param ulEnclosureNumber [in]

The number of the enclosure that contains the drive. This parameter corresponds to the ulEnclosureNumber member of the VDS_DRIVE_PROP2 structure.

-param ppDrive [out]

The address of an IVdsDrive interface pointer. Callers must release the interface.

-returns

This method can return standard HRESULT values, such as E_INVALIDARG or E_OUTOFMEMORY, and VDS-specific return values. It can also return converted system error codes using the HRESULT_FROM_WIN32 macro. Errors can originate from VDS itself or from the underlying VDS provider that is being used. Possible return values include the following.

Return code/value	Description
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	There is a software or communication problem inside a provider that caches information about the array. Use the IVdsHwProvider::Reenumerate method followed by the IVdsHwProvider::Refresh method to restore the cache.
VDS_E_OBJECT_DELETED 0x8004240BL	The subsystem object is no longer present.
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	The subsystem is in a failed state and is unable to perform the requested operation.
VDS_E_ANOTHER_CALL_IN_PROGRESS 0x80042404L	Another operation is in progress; this operation cannot proceed until the previous operation or operations are complete.