Compartir a través de


Método IVdsSubSystem::GetDrive (vdshwprv.h)

[A partir de Windows 8 y Windows Server 2012, la interfaz COM del servicio de disco virtual se sustituye por la API de administración de almacenamiento de Windows.]

Devuelve la unidad especificada.

Sintaxis

HRESULT GetDrive(
  [in]  SHORT     sBusNumber,
  [in]  SHORT     sSlotNumber,
  [out] IVdsDrive **ppDrive
);

Parámetros

[in] sBusNumber

Número del autobús al que está conectada la unidad.

[in] sSlotNumber

Número de la ranura que ocupa la unidad.

[out] ppDrive

Dirección de un puntero de interfaz IVdsDrive . Los autores de llamadas deben liberar la interfaz .

Valor devuelto

Este método puede devolver valores HRESULT estándar, como E_INVALIDARG o E_OUTOFMEMORY, y valores devueltos específicos de VDS. También puede devolver códigos de error del sistema convertidos mediante la macro HRESULT_FROM_WIN32 . Los errores pueden originarse en VDS en sí o en el proveedor de VDS subyacente que se está usando. Entre los valores devueltos posibles se incluyen los siguientes.

Código o valor devuelto Descripción
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
Este valor devuelto indica un problema de software o comunicación dentro de un proveedor que almacena en caché información sobre la matriz. Use el método IVdsHwProvider::Reenumerate seguido del método IVdsHwProvider::Refresh para restaurar la memoria caché.
VDS_E_OBJECT_DELETED
0x8004240BL
El objeto subsistema ya no está presente.
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
El subsistema está en estado de error y no puede realizar la operación solicitada.
VDS_E_ANOTHER_CALL_IN_PROGRESS
0x80042404L
Otra operación está en curso; esta operación no puede continuar hasta que se completen las operaciones o operaciones anteriores.

Comentarios

Dado que sSlotNumber y sBusNumber identifican una unidad exclusivamente, los implementadores pueden asignar valores arbitrarios (pero coherentes) a cada uno como una forma interna de identificar las unidades. Para obtener más información sobre los números de bus y ranura, vea los miembros sInternalBusNumber y sSlotNumber de la estructura de VDS_DRIVE_PROP .

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado vdshwprv.h
Library Uuid.lib

Consulte también

IVdsDrive

IVdsHwProvider::Reenumerate

IVdsHwProvider::Refresh

IVdsSubSystem

IVdsSubSystem::QueryDrives