Metodo IVssBackupComponents::D oSnapshotSet (vsbackup.h)

Articolo
08/27/2023

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