Fonction FhServiceStartBackup (fhsvcctl.h)

Cette fonction démarre une sauvegarde immédiate pour l’utilisateur actuel.

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

Voir aussi

FhServiceOpenPipe

FhServiceStopBackup

IFhConfigMgr::QueryProtectionStatus