Metodo IVssComponent::GetBackupMetadata (vswriter.h)

  • Articolo

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
S_OK
 È stato restituito correttamente il valore dell'attributo.
S_FALSE
 A questo componente non sono associati metadati di backup.
E_INVALIDARG
 Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY
 Il chiamante non è in memoria o in altre risorse di sistema.
VSS_E_INVALID_XML_DOCUMENT
 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

Vedi anche

IVssComponent

IVssComponent::SetBackupMetadata