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


Функция FhServiceStartBackup (fhsvcctl.h)

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

Примечание

Функция FhServiceStartBackup является устаревшей и может быть изменена или недоступна в будущих выпусках.

Синтаксис

HRESULT FhServiceStartBackup(
  [in] FH_SERVICE_PIPE_HANDLE Pipe,
  [in] BOOL                   LowPriorityIo
);

Параметры

[in] Pipe

Дескриптор канала связи, возвращенный предыдущим вызовом FhServiceOpenPipe .

[in] LowPriorityIo

Если задано значение TRUE, службе журнала файлов предписывается использовать низкоприоритетный ввод-вывод для немедленного резервного копирования, запланированного этой функцией. Низкоприоритетный ввод-вывод снижает влияние на действия пользователей переднего плана. Рекомендуется задать для этого параметра значение TRUE.

Если значение РАВНО FALSE, службе журнала файлов предписывается использовать обычный приоритет ввода-вывода для немедленного резервного копирования, запланированного этой функцией. Это приводит к ускорению резервного копирования, но негативно влияет на скорость отклика и производительность пользовательских приложений.

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

S_OK об успешном выполнении или неудачное выполнение HRESULT при сбое. Возможные неудачные значения HRESULT включают значения, определенные в файле заголовка FhErrors.h.

Комментарии

Эта функция не дожидается немедленного завершения резервного копирования. Если во время резервного копирования возникает ошибка или предупреждение, оно передается пользователю через уведомление центра уведомлений и программно извлекается с помощью метода IFhConfigMgr::QueryProtectionStatus .

Цикл резервного копирования, инициированный вызовом этой функции, можно остановить с помощью функции FhServiceStopBackup .

Требования

   
Минимальная версия клиента Windows 8 [только классические приложения]
Минимальная версия сервера Windows Server 2012 [только классические приложения]
Целевая платформа Windows
Header fhsvcctl.h
Библиотека FhSvcCtl.lib

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

FhServiceOpenPipe

FhServiceStopBackup

IFhConfigMgr::QueryProtectionStatus