Metodo IVssComponent::GetBackupMetadata (vswriter.h)
Il metodo GetBackupMetadata recupera i metadati di backup privati specifici del writer che potrebbero essere stati impostati durante un evento PrepareForBackup da CVssWriter::OnPrepareBackup usando IVssComponent::SetBackupMetadata.
Solo un writer può chiamare questo metodo.
Sintassi
HRESULT GetBackupMetadata(
[out] BSTR *pbstrData
);
Parametri
[out] pbstrData
Indirizzo di una variabile allocata dal chiamante che riceve una stringa contenente i metadati di backup aggiunti durante un evento OnPrepareBackup .
Valore restituito
Di seguito sono riportati i codici restituiti validi per questo metodo.
| Valore | Significato |
|---|---|
|
È stato restituito correttamente il valore dell'attributo. |
|
A questo componente non sono associati metadati di backup. |
|
Uno dei valori dei parametri non è valido. |
|
Il chiamante non è in memoria o in altre risorse di sistema. |
|
Documento XML non valido. Per informazioni dettagliate, vedere il registro eventi. 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.
Se non sono stati impostati metadati di backup, GetBackupMetadata restituisce S_FALSE.
Se la chiamata a GetBackupMetadata ha esito positivo, il chiamante è responsabile della liberazione della stringa restituita nel parametro pbstrMetadata chiamando la funzione SysFreeString .
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 | vswriter.h (include Vss.h, VsWriter.h) |
| Libreria | VssApi.lib |