Metodo IVdsSubSystem::Reenumerate (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.

Richiede al sottosistema di analizzare il bus per individuare le unità appena connesse o le unità appena disconnesse.

Sintassi

HRESULT Reenumerate();

Valore restituito

Questo metodo può restituire valori HRESULT standard, ad esempio 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
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

La maggior parte dei sottosistemi rileva automaticamente nuove connessioni e disconnessioni. Tuttavia, per quelli che non sono, questo metodo fornisce un mezzo per avviare manualmente il rilevamento. Questa operazione può richiedere molto tempo per completare.

Quando questo metodo rileva un'unità appena connessa, il provider crea un nuovo oggetto unità per esso. Quando il metodo rileva un'unità appena disconnessa, il provider mantiene l'oggetto unità precedente fino alla rimozione dell'ultimo riferimento VDS e quindi elimina l'oggetto.

Ogni oggetto deve avere un identificatore univoco e persistente. Un ID oggetto deve essere un GUID valido. Gli implementatori devono mantenere un ID oggetto in ogni rinumerazione usando questo metodo per gli oggetti esistenti prima e dopo la rinumerazione.

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

IVdsHwProvider::Reenumerate

IVdsHwProvider::Refresh

IVdsLun::GetProperties

IVdsSubSystem