Metodo IVssBackupComponents::GetSnapshotProperties (vsbackup.h)
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 |
|---|---|
|
Restituito correttamente le proprietà di copia shadow. |
|
Il chiamante non dispone di privilegi di backup sufficienti o non è un amministratore. |
|
Uno dei valori dei parametri non è valido. |
|
Il chiamante non è in memoria o altre risorse di sistema. |
|
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. |
|
La copia shadow specificata non esiste. |
|
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. |
|
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. |
|
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 |
Vedi anche
IVssBackupComponents::AddToSnapshotSet