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
S_OK	Restituito correttamente il valore dell'attributo.
S_FALSE	L'attributo specificato non ha un valore.
E_INVALIDARG	Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY	Il chiamante non è in memoria o altre risorse di sistema.
VSS_E_INVALID_XML_DOCUMENT	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

Vedi anche

IVssComponent