Fonction FhServiceStartBackup (fhsvcctl.h)
Cette fonction démarre une sauvegarde immédiate pour l’utilisateur actuel.
Notes
FhServiceStartBackup est déconseillé et peut être modifié ou indisponible dans les versions ultérieures.
Syntaxe
HRESULT FhServiceStartBackup(
[in] FH_SERVICE_PIPE_HANDLE Pipe,
[in] BOOL LowPriorityIo
);
Paramètres
[in] Pipe
Handle de canal de communication retourné par un appel FhServiceOpenPipe antérieur.
[in] LowPriorityIo
Si la valeur est TRUE, le service d’historique des fichiers est invité à utiliser des E/S de faible priorité pour la sauvegarde immédiate planifiée par cette fonction. Les E/S de faible priorité réduisent l’impact sur les activités des utilisateurs au premier plan. Il est recommandé de définir ce paramètre sur TRUE.
Si la valeur est FALSE, le service d’historique des fichiers est invité à utiliser les E/S de priorité normale pour la sauvegarde immédiate planifiée par cette fonction. Cela entraîne des sauvegardes plus rapides, mais affecte négativement la réactivité et les performances des applications utilisateur.
Valeur retournée
S_OK sur la réussite ou un HRESULT infructueux en cas d’échec. Les valeurs HRESULT potentiellement infructueuses incluent les valeurs définies dans le fichier d’en-tête FhErrors.h.
Notes
Cette fonction n’attend pas la fin de la sauvegarde immédiate. Si une condition d’erreur ou d’avertissement est rencontrée lors de la sauvegarde, elle est communiquée à l’utilisateur via une notification du Centre de notifications et peut être récupérée par programme via la méthode IFhConfigMgr::QueryProtectionStatus .
Un cycle de sauvegarde lancé en appelant cette fonction peut être arrêté à l’aide de la fonction FhServiceStopBackup .
Spécifications
| Client minimal pris en charge | Windows 8 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2012 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | fhsvcctl.h |
| Bibliothèque | FhSvcCtl.lib |