FhServiceStartBackup-Funktion (fhsvcctl.h)
Diese Funktion startet eine sofortige Sicherung für den aktuellen Benutzer.
Hinweis
FhServiceStartBackup ist veraltet und kann in zukünftigen Versionen geändert oder nicht mehr verfügbar sein.
Syntax
HRESULT FhServiceStartBackup(
[in] FH_SERVICE_PIPE_HANDLE Pipe,
[in] BOOL LowPriorityIo
);
Parameter
[in] Pipe
Das Kommunikationskanalhandle, das von einem früheren FhServiceOpenPipe-Aufruf zurückgegeben wurde.
[in] LowPriorityIo
Wenn TRUE, wird der Dateiverlaufsdienst angewiesen, E/A mit niedriger Priorität für die sofortige Sicherung zu verwenden, die von dieser Funktion geplant ist. E/A mit niedriger Priorität reduziert die Auswirkungen auf Benutzeraktivitäten im Vordergrund. Es wird empfohlen, diesen Parameter auf TRUE festzulegen.
Bei FALSE wird der Dateiverlaufsdienst angewiesen, die normale E/A-Priorität für die von dieser Funktion geplante sofortige Sicherung zu verwenden. Dies führt zu schnelleren Sicherungen, wirkt sich jedoch negativ auf die Reaktionsfähigkeit und Leistung von Benutzeranwendungen aus.
Rückgabewert
S_OK auf Erfolg oder ein nicht erfolgreiches HRESULT bei Einem Fehler. Mögliche nicht erfolgreiche HRESULT-Werte umfassen Werte, die in der FhErrors.h-Headerdatei definiert sind.
Hinweise
Diese Funktion wartet nicht, bis die sofortige Sicherung abgeschlossen ist. Wenn während der Sicherung ein Fehler oder eine Warnungsbedingung auftritt, wird sie dem Benutzer über eine Info-Center-Benachrichtigung mitgeteilt und programmgesteuert über die IFhConfigMgr::QueryProtectionStatus-Methode abgerufen.
Ein Sicherungszyklus, der durch Aufrufen dieser Funktion initiiert wird, kann mit der Funktion FhServiceStopBackup beendet werden.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | fhsvcctl.h |
| Bibliothek | FhSvcCtl.lib |