Метод CVssWriter::GetCurrentSnapshotSetId (vswriter.h)
Метод GetCurrentSnapshotSetId возвращает уникальный идентификатор набора теневых копий.
GetCurrentSnapshotSetId — это защищенный метод, реализованный базовым классом CVssWriter .
Синтаксис
VSS_ID GetCurrentSnapshotSetId();
Возвращаемое значение
Этот метод возвращает VSS_ID значение текущего набора теневого копирования.
Идентификатор набора теневого копирования, возвращаемый Командлетом GetCurrentSnapshotSetId , является идентификатором набора теневого копирования операции резервного копирования, в которую в настоящее время участвует модуль записи.
Обратите внимание, что модуль записи может участвовать в нескольких операциях резервного копирования в данный момент времени. Таким образом, если этот метод не вызывается в рамках последовательности резервного копирования, то есть не вызывается из обработчика событий, то возвращается идентификатор набора теневого копирования, непредсказуемо.
Если GetCurrentSnapshotSetId вызывается как часть последовательности резервного копирования, например из CVssWriter::OnFreeze, CVssWriter::OnThaw или CVssWriter::OnPostSnapshot, инфраструктура VSS гарантирует, что возвращаемое значение VSS_ID равно значению теневой копии, поддерживающей текущую операцию резервного копирования.
Однако это нельзя сказать для вызовов GetCurrentSnapshotSetId из обработчика событий BackupShutdownCVssWriter::OnBackupShutdown. Если событие BackupShutdown вызывается из-за внезапного завершения работы инициатора запроса, возвращаемое VSS_ID может быть событием другой операции резервного копирования, в которую принимал участие модуль записи.
Метод GetCurrentSnapshotSetId нельзя вызвать после возврата CVssWriter::OnPostSnapshot .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | vswriter.h (включая Vss.h, VsWriter.h) |
| Библиотека | VssApi.lib |