Metodo IVssComponent::GetRestoreMetadata (vswriter.h)
Il metodo GetRestoreMetadata recupera metadati di ripristino privati e specifici del writer che potrebbero essere stati impostati durante un evento PreRestore da CVssWriter::OnPreRestore usando IVssComponent::SetRestoreMetadata.
Solo un writer può chiamare questo metodo.
Sintassi
HRESULT GetRestoreMetadata(
[out] BSTR *pbstrRestoreMetadata
);
Parametri
[out] pbstrRestoreMetadata
Stringa contenente i metadati di ripristino.
Valore restituito
Di seguito sono riportati i codici restituiti validi per questo metodo.
| Valore | Significato |
|---|---|
|
Restituito correttamente il valore dell'attributo. |
|
L'attributo specificato non ha un valore. |
|
Uno dei valori dei parametri non è valido. |
|
Il chiamante non è in memoria o altre risorse di sistema. |
|
Il documento XML non è valido. Controllare il registro eventi per informazioni dettagliate. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS. |
Commenti
Questo metodo può essere chiamato in qualsiasi momento a seconda della logica di un determinato writer.
Il chiamante deve liberare la memoria contenuta dal parametro pbstrRestoreMetadata chiamando SysFreeString.
Se non sono stati impostati metadati di backup, GetBackupMetadata restituisce S_FALSE.
Un writer che imposta il metodo di ripristino su VSS_RME_RESTORE_TO_ALTERNATE_LOCATION senza definire un mapping di percorso alternativo costituisce un errore di writer.
Requisiti
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | vswriter.h (include Vss.h, VsWriter.h) |
| Libreria | VssApi.lib |