VSS_SNAPSHOT_PROP 結構 (vss.h)

發行項
03/03/2024

VSS_SNAPSHOT_PROP 結構包含陰影複製或陰影複製集的屬性。

語法

typedef struct _VSS_SNAPSHOT_PROP {
  VSS_ID             m_SnapshotId;
  VSS_ID             m_SnapshotSetId;
  LONG               m_lSnapshotsCount;
  VSS_PWSZ           m_pwszSnapshotDeviceObject;
  VSS_PWSZ           m_pwszOriginalVolumeName;
  VSS_PWSZ           m_pwszOriginatingMachine;
  VSS_PWSZ           m_pwszServiceMachine;
  VSS_PWSZ           m_pwszExposedName;
  VSS_PWSZ           m_pwszExposedPath;
  VSS_ID             m_ProviderId;
  LONG               m_lSnapshotAttributes;
  VSS_TIMESTAMP      m_tsCreationTimestamp;
  VSS_SNAPSHOT_STATE m_eStatus;
} VSS_SNAPSHOT_PROP, *PVSS_SNAPSHOT_PROP;

成員

m_SnapshotId

VSS_ID (GUID) 唯一識別陰影複製識別碼。

m_SnapshotSetId

VSS_ID (GUID) 唯一識別包含陰影複製的陰影複製集。

m_lSnapshotsCount

建立陰影複製集內含陰影複製的磁碟區數目。因為應用程式可以在不釋放陰影複製集的情況下釋放個別陰影複製，所以在任何指定的時間，陰影複製集中的陰影複製數目可能小於 m_LSnapshotsCount。

陰影複製集允許的陰影複製磁碟區數目上限為 64。

m_pwszSnapshotDeviceObject

以 Null 結尾的寬字元字串，其中包含磁碟區陰影複製的裝置物件名稱。裝置物件可以視為磁碟區陰影複製的根目錄。要求者會在存取陰影複製磁碟區上需要使用的檔案時，使用此裝置名稱。

裝置名稱不包含尾端的”

m_pwszOriginalVolumeName

以 Null 結尾的寬字元字串，其中包含已複製陰影的磁碟區名稱。

m_pwszOriginatingMachine

以 Null 結尾的寬字元字串，其中包含包含原始磁碟區的計算機名稱。

m_pwszServiceMachine

以 Null 結尾的寬字元字串，其中包含執行建立陰影複製之磁碟區陰影複製服務的電腦名稱。

m_pwszExposedName

在公開陰影複製時，以 Null 結束的寬字元字串，其中包含陰影複製的名稱。如果陰影複製公開為本機磁碟區) 或共享名稱，則這是驅動器號或掛接資料夾 (。對應至 IVssBackupComponents：：ExposeSnapshot 方法的 wszExpose 參數。

m_pwszExposedPath

以 Null 結束的寬字元字串，指出當磁碟區公開為共用時，可供使用之磁碟區的陰影複製部分。對應至 IVssBackupComponents：：ExposeSnapshot 方法的 wszPathFromRoot 參數。

m_ProviderId

VSS_ID (GUID) 唯一識別用來建立此陰影複製的提供者。

m_lSnapshotAttributes

陰影複製的屬性會以位掩碼表示 (或位 OR) _VSS_VOLUME_SNAPSHOT_ATTRIBUTES 列舉的成員。

m_tsCreationTimestamp

指出陰影複製建立時間的時間戳。確切的時間是由提供者所決定。如需時間戳格式的相關信息，請參閱VSS_TIMESTAMP 。

m_eStatus

目前的陰影複製建立狀態。請參閱 VSS_SNAPSHOT_STATE。

備註

要求者通常會使用 IVssBackupComponents：：GetSnapshotProperties 方法或 IVssSoftwareSnapshotProvider：：GetSnapshotProvider：：GetSnapshotProperties 方法，取得VSS_SNAPSHOT_PROP結構的指標。當不再需要這個結構時，呼叫端會負責使用 VssFreeSnapshotProperties 函式來釋放它。

包含在 m_pwszSnapshotDeviceObject 中的陰影複製裝置對像是用來尋址磁碟區陰影複製上的檔案。例如，如果原始磁碟區具有路徑為「\topleveldir\File.html」的檔案，則檔案的陰影複製路徑為「m_pwszSnapshotDeviceObject」+“\topleveldir\File.html”。

當陰影複製公開為共用時， m_pwszExposedName 的值將會是共用名。當陰影複製公開為驅動器號或掛接資料夾時，陰影複製 m_pwszExposedName 是驅動器號後面接著冒號，例如 “X：” 或掛接的資料夾路徑 (例如“Y：\MountX”) 。

如果陰影複製公開為驅動器號或掛接資料夾，則 (如同掛接任何裝置，) 從根目錄開始的整個陰影複製將會在裝入點公開。在此情況下， m_pwszExposedPath 會是 null。

如果陰影複製公開為共用， 則 m_pwszExposedPath 的值會是共用磁碟區部分的路徑。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
標頭	vss.h