CVssWriter::GetCurrentSnapshotSetId-Methode (vswriter.h)

Die GetCurrentSnapshotSetId-Methode gibt den eindeutigen Bezeichner des Schattenkopiensatzes zurück.

GetCurrentSnapshotSetId ist eine geschützte Methode, die von der CVssWriter-Basisklasse implementiert wird.

Syntax

VSS_ID GetCurrentSnapshotSetId();

Rückgabewert

Diese Methode gibt den VSS_ID Wert des aktuellen Schattenkopiensatzes zurück.

Die von GetCurrentSnapshotSetId zurückgegebene Id des Schattenkopiersatzes ist die ID des Sicherungsvorgangs, an dem ein Writer derzeit beteiligt ist.

Beachten Sie, dass ein Writer zu einem bestimmten Zeitpunkt an mehreren Sicherungsvorgängen beteiligt sein kann. Wenn diese Methode nicht als Teil einer Sicherungssequenz aufgerufen wird, d. h. nicht von einem Ereignishandler aufgerufen wird, ist die zurückgegebene Schattenkopiergruppen-ID daher unvorhersehbar.

Wenn GetCurrentSnapshotSetId als Teil einer Sicherungssequenz aufgerufen wird, z. B. aus CVssWriter::OnFreeze, CVssWriter::OnThaw oder CVssWriter::OnPostSnapshot, garantiert die VSS-Infrastruktur, dass der zurückgegebene VSS_ID Wert der Schattenkopie entspricht, die den aktuellen Sicherungsvorgang unterstützt.

Dies kann jedoch nicht für Aufrufe von GetCurrentSnapshotSetId innerhalb des BackupShutdown-EreignishandlersCVssWriter::OnBackupShutdown gesagt werden. Wenn ein BackupShutdown-Ereignis aufgrund eines abrupten Herunterfahrens eines Anforderers aufgerufen wird, kann die zurückgegebene VSS_ID die eines anderen Sicherungsvorgangs sein, an dem der Writer teilgenommen hat.

GetCurrentSnapshotSetId kann nicht aufgerufen werden, nachdem CVssWriter::OnPostSnapshot zurückgegeben wurde.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	vswriter.h (enthalten Vss.h, VsWriter.h)
Bibliothek	VssApi.lib

Weitere Informationen

CVssWriter

CVssWriter::OnFreeze

CVssWriter::OnPrepareSnapshot

CVssWriter::OnThaw

VSS_ID