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

Artículo
03/03/2024

[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