CVssWriter::GetCurrentSnapshotSetId 方法 (vswriter.h)
GetCurrentSnapshotSetId 方法會傳回陰影複製集的唯一標識符。
GetCurrentSnapshotSetId 是由 CVssWriter 基類所實作的受保護方法。
Syntax
VSS_ID GetCurrentSnapshotSetId();
傳回值
這個方法會傳回目前陰影複製集 的VSS_ID 值。
GetCurrentSnapshotSetId 所傳回的陰影複製集標識碼是寫入器目前參與之備份作業的陰影複製集標識符。
請注意,寫入器可能會在指定時間涉及多個備份作業。 因此,如果未呼叫這個方法做為備份順序的一部分,也就是未從事件處理程式呼叫,則會無法預期傳回陰影複製集標識符。
如果 GetCurrentSnapshotSetId 被呼叫為備份順序的一部分,例如,從 CVssWriter::OnFreeze、CVssWriter::OnThaw 或 CVssWriter::OnPostSnapshot—VSS 基礎結構會保證傳回的VSS_ID值是支援目前備份作業的陰影複製。
不過,這無法用於從 BackupShutdown 事件處理程式 CVssWriter::OnBackupShutdown 呼叫 GetCurrentSnapshotSetId。 如果因為要求者的突然關機而呼叫 BackupShutdown 事件,傳回 的VSS_ID 可能是寫入器參與的另一個備份作業。
在 CVssWriter::OnPostSnapshot 傳回之後,無法呼叫 GetCurrentSnapshotSetId。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | vswriter.h (包括 Vss.h、VsWriter.h) |
程式庫 | VssApi.lib |