Metodo IVssHardwareSnapshotProvider::OnLunEmpty (vsprov.h)

  • Articolo

Il metodo OnLunEmpty viene chiamato ogni volta che VSS determina che un LUN di copia shadow non contiene dati interessanti. Tutte le copie shadow sono state eliminate (che causano anche l'eliminazione del LUN). Le risorse LUN possono essere recuperate dal provider e riutilizzate per un altro scopo. VSS smonterà tutti i volumi interessati. Un provider non deve eseguire una nuova analisi durante OnLunEmpty. VsS gestirà questa pulizia.

Nota I provider hardware sono supportati solo nei sistemi operativi Windows Server.
 

Sintassi

HRESULT OnLunEmpty(
  [in] VSS_PWSZ            wszDeviceName,
  [in] VDS_LUN_INFORMATION *pInformation
);

Parametri

[in] wszDeviceName

Dispositivo corrispondente al LUN che contiene la copia shadow da eliminare.

[in] pInformation

Puntatore a una struttura VDS_LUN_INFORMATION contenente informazioni sul LUN contenente la copia shadow da eliminare.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice/valore restituito Descrizione
S_OK
0x00000000L
 L'operazione è stata completata correttamente.
E_OUTOFMEMORY
0x8007000EL
 Memoria insufficiente o altre risorse di sistema.
E_INVALIDARG
0x80070057L
 Uno dei valori dei parametri non è valido.
VSS_E_PROVIDER_VETO
0x80042306L
 Si è verificato un errore del provider imprevisto. Il provider deve segnalare un evento nel registro eventi dell'applicazione che fornisce all'utente informazioni su come risolvere il problema.

Commenti

I provider hardware devono eliminare una copia shadow e recuperare il LUN se e solo se
OnLunEmpty viene chiamato. Una copia shadow hardware può essere usata come supporto di backup stesso, pertanto le LUN devono essere trattate con la stessa attenzione che la matrice di archiviazione tratta le LUN usate per i dischi regolari. Il recupero di LUN al di fuori dell'elaborazione per OnLunEmpty deve essere limitato all'emergenza o a un amministratore che esegue manualmente un'azione esplicita.

Nel caso di copie shadow persistenti, il richiedente elimina la copia shadow quando non è più necessaria. Nel caso di copie shadow di rilascio automatico nonperistenti, il servizio VSS elimina la copia shadow quando il richiedente chiama IUnknown::Release nell'oggetto IVssBackupComponents . Nel caso di copia shadow non automatica non automatica, il servizio VSS elimina la copia shadow quando il computer viene riavviato. In tutti i casi, il servizio VSS chiama il metodo OnLunEmpty del provider in base alle esigenze per ogni LUN di copia shadow.

Si noti che OnLunEmpty viene chiamato su base ottimale. VSS richiama il metodo solo quando il LUN è garantito che sia vuoto. Potrebbero verificarsi molti casi in cui il LUN è vuoto, ma VSS non è in grado di rilevare questo problema a causa di errori o circostanze esterne. In questo caso, l'utente deve usare il software di gestione dell'archiviazione per cancellare questo stato.

Di seguito alcuni esempi:

  • Quando un LUN di copia shadow viene spostato in un host diverso, ma non viene effettivamente trasportato o importato tramite VSS, quindi tale LUN viene visualizzato come qualsiasi altro LUN e i volumi possono essere semplicemente eliminati senza alcuna notifica di VSS.
  • Arresto anomalo o riavvio imprevisto al centro di una creazione di copia shadow.
  • Importazione annullata.

Requisiti

Requisito Valore
Client minimo supportato Nessuno supportato
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione vsprov.h

Vedi anche

IVssHardwareSnapshotProvider