Метод IVssProviderCreateSnapshotSet::P reFinalCommitSnapshots (vsprov.h)

Статья
03/13/2024

Метод PreFinalCommitSnapshots позволяет поставщикам поддерживать теневые копии автоматического восстановления . Если в теневой копии установлен флаг VSS_VOLSNAP_ATTR_AUTORECOVER в контексте, том может получать большое количество операций записи во время операции автоматического восстановления.

Синтаксис

HRESULT PreFinalCommitSnapshots(
  [in] VSS_ID SnapshotSetId
);

Параметры

[in] SnapshotSetId

VSS_ID, идентифицирующий набор теневого копирования.

Возвращаемое значение

Возвращаемый код или значение	Описание
S_OK 0x00000000L	Операция успешно завершена.
E_OUTOFMEMORY 0x8007000EL	Нехватка памяти или других системных ресурсов.
E_INVALIDARG 0x80070057L	Одно из значений параметра является недопустимым.
VSS_E_PROVIDER_VETO 0x80042306L	Произошла непредвиденная ошибка поставщика. Если это возвращается, ошибка должна быть описана в записи в журнале событий приложения, чтобы предоставить пользователю сведения о том, как устранить проблему.

Если возвращается какое-либо другое значение, VSS запишет событие в журнал событий и преобразует ошибку в VSS_E_UNEXPECTED_PROVIDER_ERROR.

Этот метод был добавлен для обеспечения совместимости двоичных файлов, когда функция автоматического восстановления появилась в Windows Server 2003 с пакетом обновления 1 (SP1).

Примечание Для Windows Server 2003 рекомендуется, чтобы поставщики оборудования реализовали этот метод, используя следующий пример:

HRESULT PreFinalCommitSnapshots(
VSS_ID     /* SnapshotSetId */
)
{
    return S_OK;
}

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	vsprov.h

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

IVssProviderCreateSnapshotSet

Share via