Метод CVssWriterEx::SubscribeEx (vswriter.h)

Статья
08/27/2023

Вызывает подписку модуля записи на события VSS.

Синтаксис

HRESULT SubscribeEx(
  [in] DWORD dwUnsubscribeTimeout,
  [in] DWORD dwEventFlags
);

Параметры

[in] dwUnsubscribeTimeout

Продолжительность времени (в миллисекундах), в течение времени ожидания метода до истечения времени ожидания.

[in] dwEventFlags

Битовая маска VSS_SUBSCRIBE_MASK значений , указывающих на события, о которые VSS должен уведомлять модуль записи.

Значение по умолчанию для этого аргумента — (VSS_SM_BACKUP_EVENTS_FLAG | VSS_SM_RESTORE_EVENTS_FLAG). В настоящее время вызывающий объект не должен переопределять значение по умолчанию.

Этот параметр зарезервирован для использования в будущем.

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

Ниже приведены допустимые коды возврата для этого метода.

Значение	Значение
S_OK	Запись записи успешно подписана.
E_ACCESSDENIED	Вызывающий объект не имеет достаточных прав на резервное копирование или не является администратором.
E_OUTOFMEMORY	У вызывающего объекта не хватает памяти или других системных ресурсов.
VSS_E_UNEXPECTED	Непредвиденная ошибка. Код ошибки записывается в файл журнала ошибок. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS. Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается до Windows Server 2008 R2 и Windows 7. вместо этого используется E_UNEXPECTED.
VSS_E_WRITER_ALREADY_SUBSCRIBED	Модуль записи ранее вызывал этот метод.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	vswriter.h (включая Vss.h, VsWriter.h)
Библиотека	VssApi.lib

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

CVssWriter::Subscribe

CVssWriterEx

Поделиться через