Metodo IVdsProviderPrivate::OnUnload (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.]

Richiede all'oggetto provider di annullare l'inizializzazione.

Sintassi

HRESULT OnUnload(
  [in] BOOL bForceUnload
);

Parametri

[in] bForceUnload

Se true, VDS tenta di scaricare forzatamente il provider. Se false, il VDS non esegue alcun tentativo di questo tipo.

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 provenire dal VDS stesso o dal provider VDS sottostante in uso. I valori restituiti possibili includono quanto segue.

Codice restituito Descrizione
S_OK
 Il provider viene scaricato.
S_FALSE
 Il provider non è in grado di scaricare in questo momento. VDS riprova più tardi.

Commenti

VDS chiama questo metodo immediatamente prima di rilasciare il riferimento all'oggetto provider. Quando il conteggio dei riferimenti scende a zero, il provider scarica. Se il metodo OnLoad ha esito negativo, VDS non chiama OnUnload.

Note per gli implementatori: È necessario eseguire tutte le operazioni di pulizia necessarie, anche senza la chiamata a OnUnload.

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

IVdsProviderPrivate

IVdsProviderPrivate::OnLoad