Metodo IVdsHwProvider::Refresh (vdshwprv.h)

  • Articolo

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

Aggiorna i dati memorizzati internamente nella cache dei sottosistemi esistenti gestiti dai provider VDS.

Sintassi

HRESULT Refresh();

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 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_STATUS_FAILED
0x80042431L
 Il provider 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.
VDS_E_INITIALIZE_NOT_CALLED
0x80042402L
 Il metodo di inizializzazione non è stato chiamato.

Commenti

VDS gestisce una cache di informazioni sulle proprietà di tutti gli oggetti VDS, ad esempio sottosistemi e controller. Ogni volta che si verifica una modifica che attiva una notifica, questa cache viene aggiornata. Nei casi in cui la cache non viene aggiornata correttamente, le applicazioni possono chiamare questo metodo per aggiornare la cache. Si noti che la chiamata a questo metodo per aggiornare la cache può attivare notifiche aggiuntive.

Questo metodo non esegue una query sulla rete per trovare i sottosistemi appena connessi. Per individuare i sottosistemi appena connessi e disconnessi, usare il metodo IVdsHwProvider::Reenumerate .

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

IVdsHwProvider::Reenumerate

IVdsHwProvider::Refresh