Condividi tramite


Metodo IVssBackupComponents::D oSnapshotSet (vsbackup.h)

Esegue il commit di tutte le copie shadow in questo set contemporaneamente.

Sintassi

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

Parametri

[out] ppAsync

Puntatore indiretto doubly all'interfaccia asincrona IVssAsync richiesta. Viene usato per eseguire una query sullo stato di esecuzione del metodo e per recuperare il codice di errore finale.

Valore restituito

Di seguito sono riportati i codici restituiti validi per questo metodo. Questi codici di errore possono essere restituiti da questo metodo o dal metodo QueryStatus nell'interfaccia IVssAsync restituita nel parametro ppAsync .

Valore Significato
S_OK
È stato restituito un puntatore a un'istanza dell'interfaccia IVssAsync . Vedere IVssAsync::QueryStatus per i valori validi restituiti dal parametro pHrResult .
E_ACCESSDENIED
Il chiamante non dispone di privilegi di backup sufficienti o non è un amministratore.
E_INVALIDARG
ppAsync non punta a un puntatore valido; vale a dire, è NULL.
E_OUTOFMEMORY
Il chiamante non è in memoria o in altre risorse di sistema.
VSS_E_BAD_STATE
L'oggetto componenti di backup non è stato inizializzato o le chiamate prerequisite per un determinato contesto di copia shadow non sono state effettuate prima di chiamare DoSnapshotSet.
VSS_E_INSUFFICIENT_STORAGE
Lo spazio di archiviazione del sistema o del provider non è sufficiente. Se possibile, eliminare eventuali copie shadow persistenti precedenti o non necessarie e riprovare. Questo codice di errore viene restituito solo tramite il metodo QueryStatus nell'interfaccia IVssAsync restituita nel parametro ppAsync .
VSS_E_FLUSH_WRITES_TIMEOUT
Il sistema non è riuscito a scaricare le scritture di I/O. Può trattarsi di un problema temporaneo. È consigliabile attendere dieci minuti e riprovare, fino a tre volte.
VSS_E_HOLD_WRITES_TIMEOUT
Il sistema non è riuscito a contenere scritture di I/O. Può trattarsi di un problema temporaneo. È consigliabile attendere dieci minuti e riprovare, fino a tre volte.
VSS_E_NESTED_VOLUME_LIMIT
Il volume specificato è annidato troppo in profondità per partecipare all'operazione VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo codice restituito non è supportato.

VSS_E_PROVIDER_VETO
Al momento il provider non è riuscito a eseguire la richiesta. Può trattarsi di un problema temporaneo. È consigliabile attendere dieci minuti e riprovare, fino a tre volte. Questo codice di errore viene restituito solo tramite il metodo QueryStatus nell'interfaccia IVssAsync restituita nel parametro ppAsync .
VSS_E_REBOOT_REQUIRED
Il provider ha rilevato un errore che richiede all'utente di riavviare il computer.

Windows Server 2003 e Windows XP: Questo valore non è supportato.

VSS_E_TRANSACTION_FREEZE_TIMEOUT
Il sistema non è riuscito a bloccare Distributed Transaction Coordinator (DTC) o Kernel Transaction Manager (KTM).

Windows Server 2003 e Windows XP: Questo valore non è supportato.

VSS_E_TRANSACTION_THAW_TIMEOUT
Il sistema non è riuscito a disgelare Distributed Transaction Coordinator (DTC) o Kernel Transaction Manager (KTM).

Windows Server 2003 e Windows XP: Questo valore non è supportato.

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.

VSS_E_UNEXPECTED_PROVIDER_ERROR
Il provider ha restituito un codice di errore imprevisto. Può trattarsi di un problema temporaneo. È consigliabile attendere dieci minuti e riprovare, fino a tre volte. Questo codice di errore viene restituito solo tramite il metodo QueryStatus nell'interfaccia IVssAsync restituita nel parametro ppAsync .

Commenti

Il chiamante è responsabile del rilascio dell'interfaccia IVssAsync .

Questo metodo non può essere chiamato per un disco rigido virtuale (VHD) annidato all'interno di un altro disco rigido virtuale.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: I dischi rigidi virtuali non sono supportati.

Per informazioni su come usare IVssBackupComponents::D oSnapshotSet per creare una copia shadow di backup standard, vedere Panoramica delle attività di pre-backup e creazione di copie shadow semplici per il backup. Per informazioni sull'uso del metodo in contesti VSS diversi, vedere Dettagli di implementazione per la creazione di copie shadow.

Requisiti

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

Vedi anche

IVssAsync

IVssBackupComponents

IVssBackupComponents::AddComponent

IVssBackupComponents::AddToSnapshotSet

IVssBackupComponents::P repareForBackup

IVssBackupComponents::StartSnapshotSet