Metodo IVssHardwareSnapshotProviderEx::ResyncLuns (vsprov.h)

Articolo
07/16/2024

Il servizio VSS chiama questo metodo per notificare ai provider hardware che è necessaria una risincronizzazione LUN.

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

Sintassi

HRESULT ResyncLuns(
  [in]  VDS_LUN_INFORMATION *pSourceLuns,
  [in]  VDS_LUN_INFORMATION *pTargetLuns,
  [in]  DWORD               dwCount,
  [out] IVssAsync           **ppAsync
);

Parametri

[in] pSourceLuns

Puntatore a una matrice di strutture dwCountVDS_LUN_INFORMATION, una per ogni LUN che contribuisce al volume di copia shadow.

[in] pTargetLuns

Puntatore a una matrice di strutture dwCountVDS_LUN_INFORMATION, una per ogni LUN che contribuisce al volume di destinazione in cui copiare il contenuto del volume di copia shadow.

[in] dwCount

Numero di elementi nella matrice pSourceLuns. Si tratta anche del numero di elementi nella matrice pTargetLuns.

[out] ppAsync

Puntatore a una posizione che riceverà un puntatore IVssAsync che può essere usato per recuperare lo stato dell'operazione di risincronizzazione. Al termine dell'operazione, il chiamante deve rilasciare il puntatore dell'interfaccia chiamando il metodo IUnknown::Release.

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.
VSS_E_PROVIDER_VETO 0x80042306L	Si è verificato un errore imprevisto del provider. Se viene restituito questo codice di errore, l'errore deve essere descritto in una voce nel registro eventi dell'applicazione, fornendo all'utente informazioni su come risolvere il problema.
VSS_E_INSUFFICIENT_STORAGE 0x8004231FL	Il provider non può eseguire l'operazione perché lo spazio su disco non è sufficiente.

Osservazioni

I LUN di destinazione possono essere i LUN che contribuiscono al volume di produzione originale da cui è stata creata la copia shadow oppure possono essere LUN nuovi o esistenti usati per sostituire un volume originale rimosso dall'ambiente di produzione.

Il provider deve eseguire la risincronizzazione copiando i dati a livello di matrice LUN, non a livello di host. Ciò significa che il provider non può implementare la risincronizzazione LUN semplicemente copiando il contenuto del LUN di origine nel LUN di destinazione. L'I/O necessario per eseguire la risincronizzazione LUN deve essere eseguita nell'hardware, tramite i dispositivi disco dei LUN risincronizzati e non tramite il computer host. L'I/O deve essere completamente trasparente per il computer host.

Al termine della risincronizzazione, i LUN sono completamente funzionali e sono disponibili per le operazioni di I/O.

L'hardware del disco sottostante deve supportare identificatori di dispositivo univoci di pagina 83.

Se il LUN di destinazione è maggiore del LUN di origine, il provider deve ridimensionare il LUN di destinazione, se necessario per assicurarsi che corrisponda al LUN di origine dopo la risincronizzazione.

Questo metodo non può essere chiamato in WinPE e non può essere chiamato in modalità provvisoria. Prima di chiamare questo metodo, il chiamante deve usare il metodo IVssBackupComponents::InitializeForRestore per prepararsi alla risincronizzazione.

Fabbisogno

Requisito	Valore
client minimo supportato	Nessuna supportata
server minimo supportato	Windows Server 2008 R2 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	vsprov.h

Vedere anche

IVssHardwareSnapshotProviderEx

Condividi tramite