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

表示为位掩码的卷影副本的属性 (或 _VSS_VOLUME_SNAPSHOT_ATTRIBUTES 枚举的成员的按位 OR) 。

m_tsCreationTimestamp

指示创建卷影副本的时间的时间戳。确切时间由提供程序确定。有关时间戳格式的信息，请参阅 VSS_TIMESTAMP 。

m_eStatus

当前卷影副本创建状态。请参阅 VSS_SNAPSHOT_STATE。

注解

请求者通常通过使用 IVssBackupComponents：：GetSnapshotProperties 方法或 IVssSoftwareSnapshotProvider：：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 的值将是共享卷部分的路径。