Metodo IVssComponent::GetBackupStamp (vswriter.h)
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 |
---|---|
|
Restituito correttamente il valore dell'attributo. |
|
Non è associato alcun timestamp a questo componente. |
|
Uno dei valori dei parametri non è valido. |
|
Il chiamante non è in memoria o altre risorse di sistema. |
|
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 |