Metodo IVssComponent::GetPreviousBackupStamp (vswriter.h)

  • Articolo

Il metodo GetPreviousBackupStamp restituisce un segno di backup precedente caricato da un richiedente nel documento Componenti di backup. Il valore viene usato da un writer quando si decide se i file devono partecipare all'operazione di backup differenziale o incrementale.

Un writer o un richiedente può chiamare questo metodo.

Sintassi

HRESULT GetPreviousBackupStamp(
  [out] BSTR *pbstrBackupStamp
);

Parametri

[out] pbstrBackupStamp

Puntatore a una stringa contenente il timestamp di un backup precedente in modo che sia possibile implementare correttamente un backup differenziale o incrementale.

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 è stato impostato alcun timestamp di backup precedente.
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

Per altre informazioni sui stamp di backup, vedere Ruolo writer nel backup di archivi complessi e ruolo del richiedente nel backup di archivi complessi.

Il chiamante deve liberare la memoria mantenuta dal parametro pbstrBackupStamp chiamando SysFreeString.

Se non è presente alcun timestamp di backup precedente, GetPreviousBackupStamp restituisce S_FALSE.

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 GetPreviousBackupStamp è impostato da un richiedente usando IVssBackupComponents::SetPreviousBackupStamp.

In genere, la stringa usata per impostare il valore trovato da GetPreviousBackupStamp è stata recuperata da un documento dei componenti di backup archiviato o archiviata dal richiedente come parte dei propri record interni.

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

IVssBackupComponents::SetPreviousBackupStamp

IVssComponent