Metodo IVssComponent::GetBackupStamp (vswriter.h)

  • Articolo

Il metodo GetBackupStamp restituisce la stringa di stamp di backup archiviata da un writer per un determinato componente.

Un writer o un richiedente può chiamare questo metodo.

Sintassi

HRESULT GetBackupStamp(
  [out] BSTR *pbstrBackupStamp
);

Parametri

[out] pbstrBackupStamp

Indirizzo di una variabile allocata dal chiamante che riceve una stringa contenente il timbro di backup che indica il momento in cui è stato eseguito il backup del componente.

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
 Non è associato alcun timestamp a questo componente.
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

Se non è stato impostato alcun timestamp di backup, GetBackupStamp restituisce S_FALSE.

Se la chiamata a GetBackupStamp ha esito positivo, il chiamante è responsabile della liberazione della stringa restituita nel parametro pbstrBackupStamp chiamando la funzione SysFreeString .

La stringa restituita fa riferimento a tutti i file nel componente e a qualsiasi sottocomponente non selezionabile che ha.

Il timbro di backup recuperato da GetBackupStamp è in genere impostato da un writer tramite una chiamata a IVssComponent::SetBackupStamp dall'interno del gestore eventi PostSnapshot , CVssWriter::OnPostSnapshot.

I richiedenti archiviano semplicemente i timbri di backup nel documento Componenti di backup; non usano direttamente il timbro di backup, sanno come generarlo o comprendere il relativo formato.

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

IVssBackupComponents::SetPreviousBackupStamp

IVssComponent

IVssComponent::SetBackupStamp