Metodo IVdsSubSystem::QueryDrives (vds.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 un oggetto che enumera le unità nel sottosistema.

Sintassi

HRESULT QueryDrives(
  [out] IEnumVdsObject **ppEnum
);

Parametri

[out] ppEnum

Indirizzo di un puntatore dell'interfaccia IEnumVdsObject che può essere usato per enumerare le unità come oggetti unità. Per altre informazioni, vedere Uso degli oggetti di enumerazione. I chiamanti devono rilasciare l'interfaccia e ognuno degli oggetti unità quando non sono più necessari chiamando il metodo IUnknown::Release .

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 derivare da VDS stesso o dal provider VDS sottostante usato. I valori restituiti possibili includono quanto segue.

Codice/valore restituito Descrizione
S_OK
Restituisce l'enumerazione delle unità. Se il sottosistema non dispone di unità, l'enumerazione è vuota.
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 non riuscito 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

Nel caso di stacking del provider hardware, un'unità nel sottosistema può essere un LUN in superficie da un altro sottosistema.

Gli implementatori devono restituire un oggetto di enumerazione vuoto per ogni sottosistema con unità zero.

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 vds.h
Libreria Uuid.lib

Vedi anche

IEnumVdsObject

IVdsHwProvider::Reenumerate

IVdsHwProvider::Refresh

IVdsSubSystem