2.2.3.3 VSS_SNAPSHOT_PROP Structure

The VSS_SNAPSHOT_PROP structure provides information about a shadow copy object.

 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;

m_SnapshotId: The VSS_ID (section 2.2.1.1) that identifies this shadow copy object.

m_SnapshotSetId: The VSS_ID that identifies the shadow copy set of which this shadow copy object is a member. All shadow copy objects in the same snapshot set MUST have the same value for m_SnapshotSetId.

m_lSnapshotsCount: The number of shadow copies in the shadow copy set when it was originally created. It is possible that individual shadow copies that make up the shadow copy set are deleted so that, at any time, it is possible that the number of shadow copies currently in the snapshot set is less than m_lSnapshotCount.

m_pwszSnapshotDeviceObject: The null-terminated character string that contains the name of the volume device for the shadow copy volume object on the server.<5>

m_pwszOriginalVolumeName: The null-terminated character string that contains the volume mount name of the volume from which a shadow copy was obtained in order to generate this shadow copy object.

m_pwszOriginatingMachine: The null-terminated character string that contains the name of the machine that hosts the original volume. The server MUST populate this string with the fully qualified domain name (FQDN) of the server machine. For this protocol, the value of m_pwszOriginatingMachine and m_pwszServiceMachine MUST be the same.

m_pwszServiceMachine: The null-terminated character string that contains the name of the machine on which the shadow copy was created. The server MUST populate this string with the FQDN of the server machine. For this protocol, the value of m_pwszOriginatingMachine and m_pwszServiceMachine MUST be the same.

m_pwszExposedName: The null-terminated character string that contains the drive letter, mount point, or SMB share name if the shadow copy is exposed on the server. For this protocol, the server MUST set this value to NULL.

m_pwszExposedPath: The null-terminated character string that contains the full, root-relative path to a folder on the shadow copy that is to be exposed as an SMB share. For this protocol, the server MUST set this value to NULL.

m_ProviderId: The VSS_ID of the VSS provider that was used to create the shadow copy.

m_lSnapshotAttributes: The attributes of the shadow copy. The value of this LONG value is a combination of the values that are defined in VSS_VOLUME_SNAPSHOT_ATTRIBUTES.

m_tsCreationTimestamp: The time stamp that defines when the shadow copy was created.

m_eStatus: A value from the VSS_SNAPSHOT_STATE enumeration (section 2.2.2.4) that defines the state of the snapshot. For this protocol, the value of m_eStatus MUST be VSS_SS_CREATED.