共用方式為


VSS_SNAPSHOT_PROP 結構 (vss.h)

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

另請參閱

IVssBackupComponents::ExposeSnapshot

IVssBackupComponents::GetSnapshotProperties

IVssSoftwareSnapshotProvider::GetSnapshotProperties

VSS_SNAPSHOT_STATE

VSS_TIMESTAMP

VssFreeSnapshotProperties

_VSS_SNAPSHOT_CONTEXT

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES