Metodo IVdsSubSystem::GetDrive (vdshwprv.h)

[A partire da Windows 8 e Windows Server 2012, l'interfaccia COM del servizio disco virtuale viene sostituita dall'API gestione archiviazione di Windows.]

Restituisce l'unità specificata.

Sintassi

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

Parametri

[in] sBusNumber

Numero dell'autobus a cui è connessa l'unità.

[in] sSlotNumber

Numero dello slot occupato dall'unità.

[out] ppDrive

Indirizzo di un puntatore all'interfaccia IVdsDrive . I chiamanti devono rilasciare l'interfaccia.

Valore restituito

Questo metodo può restituire valori HRESULT standard, ad esempio E_INVALIDARG o E_OUTOFMEMORY e valori restituiti specifici di VDS. Può anche restituire codici di errore di sistema convertiti usando la macro HRESULT_FROM_WIN32 . Gli errori possono provenire dal VDS stesso o dal provider VDS sottostante in uso. I valori restituiti possibili includono quanto segue.

Codice/valore restituito Descrizione
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
Questo valore restituito segnala un problema di comunicazione o software all'interno di un provider che memorizza nella cache le informazioni sulla matrice. Usare il metodo IVdsHwProvider::Reenumerate seguito dal metodo IVdsHwProvider::Refresh per ripristinare la cache.
VDS_E_OBJECT_DELETED
0x8004240BL
L'oggetto sottosistema non è più presente.
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
Il sottosistema si trova in uno stato di errore e non è in grado di eseguire l'operazione richiesta.
VDS_E_ANOTHER_CALL_IN_PROGRESS
0x80042404L
Un'altra operazione è in corso; questa operazione non può continuare fino al completamento dell'operazione o delle operazioni precedenti.

Commenti

Poiché sSlotNumber e sBusNumber identificano esclusivamente un'unità, gli implementatori possono assegnare valori arbitrari (ma coerenti) a ognuno come modo interno per identificare le unità. Per altre informazioni sui numeri di bus e slot, vedere i membri sInternalBusNumber e sSlotNumber della struttura VDS_DRIVE_PROP .

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione vdshwprv.h
Libreria Uuid.lib

Vedi anche

IVdsDrive

IVdsHwProvider::Reenumerate

IVdsHwProvider::Refresh

IVdsSubSystem

IVdsSubSystem::QueryDrives