Condividi tramite

Metodo IVdsService::Refresh (vds.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 le informazioni sulla proprietà del disco e sul layout del disco.

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

Codice/valore restituito Descrizione
S_OK
 Metodo completato correttamente.
S_FALSE
 Si è verificato un errore durante questa operazione.
VDS_E_INITIALIZED_FAILED
0x80042401L
 Non è stato possibile inizializzare il VDS. Se un'applicazione chiama questo metodo prima che il servizio finisca l'inizializzazione, il metodo viene bloccato fino al completamento dell'inizializzazione. Se l'inizializzazione ha esito negativo, viene restituito questo errore.

Commenti

Questo metodo sincronizza il layout del disco al layout noto al driver del disco. Non forza il driver a leggere il layout dal disco. Inoltre, questo metodo aggiorna la visualizzazione di tutti gli oggetti nella cache VDS. VDS e i provider e i provider eseguono query su tutti gli oggetti, inviando l'arrivo dell'oggetto, la modifica, le notifiche di rimozione per sincronizzare il chiamante. Si noti che VDS aggiorna automaticamente la cache ogni volta che rileva una modifica che attiva una notifica. Per questo motivo, e perché la chiamata a Refresh può attivare notifiche aggiuntive, le applicazioni non devono chiamare questo metodo in risposta alle notifiche. L'aggiornamento deve essere chiamato solo quando appare che la cache non viene aggiornata correttamente.

Requisiti

   
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

IVdsService