Метод 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

См. также раздел

CVssWriter

CVssWriter::OnFreeze

CVssWriter::OnPrepareSnapshot

CVssWriter::OnThaw

VSS_ID