IVssComponent：：GetBackupStamp 方法 (vswriter.h)

GetBackupStamp方法會傳回寫入器為指定元件儲存的備份戳記字串。

寫入器或要求者都可以呼叫這個方法。

語法

HRESULT GetBackupStamp(
  [out] BSTR *pbstrBackupStamp
);

[out] pbstrBackupStamp

呼叫端配置的變數位址，接收包含備份戳記的字串，指出元件備份的時間。

以下是此方法的有效傳回碼。

值	意義
S_OK	已成功傳回屬性值。
S_FALSE	沒有與此元件相關聯的時間戳記。
E_INVALIDARG	其中一個參數值無效。
E_OUTOFMEMORY	呼叫端記憶體不足或其他系統資源。
VSS_E_INVALID_XML_DOCUMENT	XML 檔無效。請檢查事件記錄檔以取得詳細資料。如需詳細資訊，請參閱 VSS 下的事件和錯誤處理。

如果未設定備份時間戳記， GetBackupStamp 會傳回S_FALSE。

如果GetBackupStamp的呼叫成功，呼叫端會藉由呼叫SysFreeString函式，負責釋放pbstrBackupStamp參數中傳回的字串。

傳回的字串是指元件中的所有檔案，以及它擁有的任何不可選取子元件。

GetBackupStamp所擷取的備份戳記通常是由寫入器從PostSnapshot事件處理常式CVssWriter：：OnPostSnapshot中呼叫IVssComponent：：SetBackupStamp所設定。

要求者只會將備份戳記儲存在備份元件檔中;它們不會直接使用備份戳記、瞭解如何產生或瞭解其格式。