Metodo IVdsHwProvider::QuerySubSystems (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 un'enumerazione dei sottosistemi gestiti dal provider.
Sintassi
HRESULT QuerySubSystems(
[out] IEnumVdsObject **ppEnum
);
Parametri
[out] ppEnum
Indirizzo di un puntatore dell'interfaccia IEnumVdsObject che può essere usato per enumerare i sottosistemi come oggetti sottosistema. Per altre informazioni, vedere Uso degli oggetti di enumerazione. I chiamanti devono rilasciare l'interfaccia e ognuno degli oggetti sottosistema 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 |
|---|---|
|
Restituisce l'enumerazione degli identificatori del sottosistema. Se il provider non gestisce sottosistemi, l'enumerazione è vuota. |
|
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. |
|
Il provider si trova in uno stato non riuscito e non è in grado di eseguire l'operazione richiesta. |
|
Un'altra operazione è in corso; questa operazione non può continuare fino al completamento dell'operazione o delle operazioni precedenti. |
|
Il metodo di inizializzazione non è stato chiamato. |
Commenti
L'oggetto restituito enumera tutti i sottosistemi attualmente connessi alla rete. Usare il metodo IVdsHwProvider::Reenumerate per individuare nuovi sottosistemi. Usare il metodo IVdsHwProvider::Refresh per aggiornare i dati del provider memorizzati nella cache interna per i sottosistemi esistenti.
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 |