Metodo IVssBackupComponents::GetSnapshotProperties (vsbackup.h)

Articolo
03/08/2023

Il metodo GetSnapshotProperties ottiene le proprietà della copia shadow specificata.

Sintassi

HRESULT GetSnapshotProperties(
  [in]  VSS_ID            SnapshotId,
  [out] VSS_SNAPSHOT_PROP *pProp
);

Parametri

[in] SnapshotId

Identificatore della copia shadow di un volume restituito da IVssBackupComponents::AddToSnapshotSet.

[out] pProp

Indirizzo di una struttura di VSS_SNAPSHOT_PROP allocata dal chiamante che riceve le proprietà di copia shadow. Il provider di software è responsabile dell'impostazione dei membri di questa struttura. Il provider software alloca la memoria per tutti i membri di stringa impostati nella struttura. Quando la struttura non è più necessaria, il provider software è responsabile della liberazione di queste stringhe chiamando la funzione VssFreeSnapshotProperties .

Valore restituito

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

Valore	Significato
S_OK	Restituito correttamente le proprietà di copia shadow.
E_ACCESSDENIED	Il chiamante non dispone di privilegi di backup sufficienti o non è un amministratore.
E_INVALIDARG	Uno dei valori dei parametri non è valido.
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 o questo metodo non è stato chiamato all'interno della sequenza corretta.
VSS_E_OBJECT_NOT_FOUND	La copia shadow specificata non esiste.
VSS_E_PROVIDER_VETO	Errore previsto del provider. Il provider ha registrato l'errore nel registro eventi. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS.
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	Errore del provider imprevisto. Il codice di errore viene registrato nel log degli errori. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS.

Commenti

Il chiamante deve impostare il contenuto della struttura VSS_SNAPSHOT_PROP su zero prima di chiamare il metodo GetSnapshotProperties .

Il provider è responsabile dell'allocazione e della liberazione delle stringhe nella struttura VSS_SNAPSHOT_PROP .

Requisiti


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