VSS_SNAPSHOT_PROP-Struktur (vss.h)

Artikel
08/27/2023

Die VSS_SNAPSHOT_PROP-Struktur enthält die Eigenschaften einer Schattenkopie oder eines Schattenkopiesatzes.

Syntax

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;

Member

m_SnapshotId

Eine VSS_ID (GUID), die den Schattenkopiebezeichner eindeutig identifiziert.

m_SnapshotSetId

Eine VSS_ID (GUID), die den Schattenkopiersatz eindeutig identifiziert, der die Schattenkopie enthält.

m_lSnapshotsCount

Anzahl der Volumes, die mit der Schattenkopie im Schattenkopiesatz enthalten sind, wenn sie erstellt wurde. Da es für Anwendungen möglich ist, einzelne Schattenkopien freizugeben, ohne den Schattenkopiensatz freizugeben, kann die Anzahl der Schattenkopien im Schattenkopiersatz jederzeit kleiner als m_LSnapshotsCount sein.

Die maximale Anzahl von schattenkopierten Volumes, die in einem Schattenkopiersatz zulässig sind, ist 64.

m_pwszSnapshotDeviceObject

Breite Zeichenfolge mit NULL-Beendigung, die den Namen des Geräteobjekts für die Schattenkopie des Volumes enthält. Das Geräteobjekt kann als Stamm einer Schattenkopie eines Volumes betrachtet werden. Anforderer verwenden diesen Gerätenamen, wenn sie auf Dateien auf einem schattenkopiertem Volume zugreifen, mit dem sie arbeiten müssen.

Der Gerätename enthält kein nachfolgendes "".

m_pwszOriginalVolumeName

Breite NULL-Zeichenfolge, die den Namen des Volumes enthält, das schattenkopiert wurde.

m_pwszOriginatingMachine

Breite NULL-Zeichenfolge, die den Namen des Computers enthält, der das ursprüngliche Volume enthält.

m_pwszServiceMachine

Breite Null-Zeichenfolge, die den Namen des Computers enthält, auf dem der Volumeschattenkopiedienst ausgeführt wird, der die Schattenkopie erstellt hat.

m_pwszExposedName

Breite NULL-Zeichenfolge, die den Namen der Schattenkopie enthält, wenn sie verfügbar gemacht wird. Dies ist ein Laufwerkbuchstabe oder eingebundener Ordner (wenn die Schattenkopie als lokales Volume verfügbar gemacht wird) oder ein Freigabename. Entspricht dem wszExpose-Parameter der IVssBackupComponents::ExposeSnapshot-Methode .

m_pwszExposedPath

Breite NULL-Zeichenfolge, die den Teil der Schattenkopie eines Volumes angibt, der verfügbar gemacht wird, wenn es als Freigabe verfügbar gemacht wird. Entspricht dem wszPathFromRoot-Parameter der IVssBackupComponents::ExposeSnapshot-Methode .

m_ProviderId

Eine VSS_ID (GUID), die den Anbieter eindeutig identifiziert, der zum Erstellen dieser Schattenkopie verwendet wird.

m_lSnapshotAttributes

Die Attribute der Schattenkopie, die als Bitmaske (oder bitweise OR) von Membern der _VSS_VOLUME_SNAPSHOT_ATTRIBUTES-Enumeration ausgedrückt werden.

m_tsCreationTimestamp

Zeitstempel, der angibt, wann die Schattenkopie erstellt wurde. Die genaue Uhrzeit wird vom Anbieter bestimmt. Informationen zum Zeitstempelformat finden Sie unter VSS_TIMESTAMP .

m_eStatus

Aktuelle Schattenkopienerstellung status. Siehe VSS_SNAPSHOT_STATE.

Hinweise

Anfordernde erhalten in der Regel einen Zeiger auf eine VSS_SNAPSHOT_PROP-Struktur mithilfe der IVssBackupComponents::GetSnapshotProperties-Methode oder der IVssSoftwareSnapshotProvider::GetSnapshotProperties-Methode . Wenn diese Struktur nicht mehr benötigt wird, ist der Aufrufer dafür verantwortlich, sie mithilfe der VssFreeSnapshotProperties-Funktion frei zu geben.

Das in m_pwszSnapshotDeviceObject enthaltene Objekt des Schattenkopiegeräts wird verwendet, um Dateien auf der Schattenkopie des Volumes zu adressieren. Wenn das ursprüngliche Volume für instance eine Datei mit dem Pfad "\topleveldir\File.html" enthält, lautet der Pfad zur Schattenkopie der Datei "m_pwszSnapshotDeviceObject"+"\topleveldir\File.html".

Wenn eine Schattenkopie als Freigabe verfügbar gemacht wird, ist der Wert von m_pwszExposedName der Freigabename. Wenn die Schattenkopie als Laufwerkbuchstaben oder eingebundenen Ordner verfügbar gemacht wird, ist die Schattenkopie m_pwszExposedName ein Laufwerkbuchstabe gefolgt von einem Doppelpunkt, z. B. "X:" oder ein eingebundener Ordnerpfad (z. B. "Y:\MountX").

Wenn eine Schattenkopie als Laufwerkbuchstabe oder eingebundener Ordner verfügbar gemacht wird, wird (wie beim Einbinden eines Geräts) die gesamte Schattenkopie ab ihrem Stamm am Bereitstellungspunkt verfügbar gemacht. In diesem Fall ist m_pwszExposedPath NULL.

Wenn die Schattenkopie als Freigabe verfügbar gemacht wird, ist der Wert von m_pwszExposedPath der Pfad zu dem Teil des Volumes, der freigegeben wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	vss.h