Metodo IVssProviderCreateSnapshotSet::CommitSnapshots (vsprov.h)

Il metodo CommitSnapshots esegue rapidamente il commit di tutti i LUN in questo provider.

Sintassi

HRESULT CommitSnapshots(
  [in] VSS_ID SnapshotSetId
);

Parametri

[in] SnapshotSetId

Il VSS_ID che identifica il set di copie shadow.

Valore restituito

Se viene restituito un altro valore, VSS scriverà un evento nel registro eventi e convertirà l'errore in VSS_E_UNEXPECTED_PROVIDER_ERROR.

Osservazioni:

Questo metodo viene chiamato al momento definito in cui devono essere eseguite le copie shadow. Per ogni LUN preparato in questo set di copie shadow, il provider eseguirà il lavoro necessario per rendere persistente il contenuto del LUN temporizzato. Durante l'esecuzione di questo metodo, sia le applicazioni che il sottosistema di I/O sono in gran parte inescenti. Il provider deve ridurre al minimo la quantità di tempo impiegato in questo metodo. Come regola generale, il completamento di questo metodo deve richiedere meno di un secondo. Questo metodo viene chiamato durante la finestra Flush and Hold (Scaricamento e blocco) e il supporto del kernel VSS annulla flush e hold se la versione non viene ricevuta entro 10 secondi, causando l'esito negativo del processo di creazione della copia shadow del servizio Copia Shadow. Se ogni provider richiede più di un secondo o due per completare questa chiamata, è probabile che l'intera creazione della copia shadow avrà esito negativo.

Poiché il sistema di I/O è inattivo, il provider deve prestare attenzione a non avviare alcuna I/O perché potrebbe bloccare il sistema, ad esempio eseguire il debug o tracciare I/O da questo metodo o qualsiasi chiamata effettuata da questo metodo. I file mappati alla memoria e l'I/O di paging non verranno bloccati al momento.

Si noti che il sistema di I/O è in stato di disattivazione solo durante l'esecuzione di questo metodo. Subito dopo il completamento del metodo CommitSnapshots dell'ultimo provider, il servizio VSS rilascia tutte le scritture in sospeso nei LUN di origine. Se il provider esegue una sincronizzazione dei LUN di copia shadow e di origine, questa sincronizzazione deve essere completata prima che venga restituito il metodo CommitSnapshots del provider; non può essere eseguita in modo asincrono.

Requisiti

Vedere anche

IVssProviderCreateSnapshotSet