Metodo IVssBackupComponents::ImportSnapshots (vsbackup.h)

Articolo
08/27/2023

Il metodo ImportSnapshots importa copie shadow trasportate da un computer diverso.

Nota Questo metodo è supportato solo nei sistemi operativi Windows Server e nei provider hardware del servizio Copia shadow del volume.

Sintassi

HRESULT ImportSnapshots(
  [out] IVssAsync **ppAsync
);

Parametri

[out] ppAsync

Puntatore indiretto doubly a un oggetto IVssAsync contenente i dati di stato della copia shadow importati.

Valore restituito

Di seguito sono riportati i codici restituiti validi per questo metodo.

Valore	Significato
S_OK	È stato restituito un puntatore a un'istanza dell'interfaccia IVssAsync . Fare riferimento alla pagina di riferimento per IVssAsync::QueryStatus per i codici di errore restituiti nel parametro pHrResult .
E_ACCESSDENIED	Il chiamante non dispone di privilegi di backup sufficienti o non è un amministratore.
E_INVALIDARG	Il parametro ppAsync non punta a un puntatore valido; vale a dire, è NULL.
E_OUTOFMEMORY	Il chiamante non è in memoria o altre risorse di sistema.
VSS_E_BAD_STATE	L'oggetto componenti di backup non viene inizializzato, questo metodo è stato chiamato durante un'operazione di ripristino oppure questo metodo non è stato chiamato dall'interno della sequenza corretta.
VSS_E_UNEXPECTED	Errore imprevisto. Il codice di errore viene registrato nel file di log degli errori. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS. Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato fino a Windows Server 2008 R2 e Windows 7. E_UNEXPECTED viene invece usato.

Commenti

È possibile importare una sola copia shadow alla volta.

Il richiedente è responsabile della serializzazione dell'operazione di copia shadow dell'importazione.

Il chiamante è responsabile del rilascio dell'interfaccia IVssAsync .

Per altre informazioni sull'importazione di copie shadow, vedere Importazione di volumi copiati shadow trasportabili.

Copie shadow trasportabili in un cluster: Per informazioni dettagliate sull'uso di copie shadow trasportabili in un cluster, vedere Fast Recovery Using Transportable Shadow Copy Volumi. La copia shadow trasportabile deve essere importata dall'esterno del cluster, purché il volume originale venga montato all'interno del cluster.

Nota Se l'importazione di copia shadow ha esito negativo, il servizio Copia shadow del volume non pulisce le LUN in modo autonomo. Il richiedente deve avviare la pulizia delle LUN.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2008, Windows Server 2003 con SP1, Windows Server 2003 Datacenter, Windows Server 2003 Enterprise [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vsbackup.h (include VsBackup.h, Vss.h, VsWriter.h)
Libreria	VssApi.lib