共用方式為


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所設定。

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

規格需求

   
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 vswriter.h (包括 Vss.h、VsWriter.h)
程式庫 VssApi.lib

另請參閱

IVssBackupComponents::SetPreviousBackupStamp

IVssComponent

IVssComponent::SetBackupStamp