Méthode IFhConfigMgr::QueryProtectionStatus (fhcfg.h)
Récupère l’état de protection actuel de l’historique des fichiers.
Notes
IFhConfigMgr est déconseillé et peut être modifié ou indisponible dans les versions ultérieures.
Syntaxe
HRESULT QueryProtectionStatus(
[out] DWORD *ProtectionState,
[out] BSTR *ProtectedUntilTime
);
Paramètres
[out] ProtectionState
Au retour, ce paramètre reçoit l’état de protection actuel de l’historique des fichiers. Les états de protection suivants sont définis dans le fichier d’en-tête FhStatus.h.
| Valeur | Signification |
|---|---|
|
L’état de protection de l’historique des fichiers est inconnu, car le service Historique des fichiers n’est pas démarré ou l’utilisateur actuel n’y est pas suivi. Cette valeur ne peut pas être ORed avec FH_STATE_RUNNING (0x100). |
|
La protection de l’historique des fichiers n’est pas activée pour l’utilisateur actuel. Aucun fichier n’est sauvegardé. Cette valeur ne peut pas être ORed avec FH_STATE_RUNNING (0x100). |
|
La protection de l’historique des fichiers est désactivée par stratégie de groupe. Aucun fichier n’est sauvegardé. Cette valeur ne peut pas être ORed avec FH_STATE_RUNNING (0x100). |
|
Il existe une erreur irrécupérable dans l’un des fichiers qui stockent les informations internes de l’historique des fichiers pour l’utilisateur actuel. Aucun fichier n’est sauvegardé. Cette valeur ne peut pas être ORed avec FH_STATE_RUNNING (0x100). |
|
L’utilisateur actuel n’a pas d’autorisation d’écriture pour la cible actuellement affectée. Les copies de sauvegarde des versions de fichier ne seront pas créées. Cette valeur peut être ORed avec FH_STATE_RUNNING (0x100) pour indiquer qu’un cycle de sauvegarde est en cours d’exécution pour l’utilisateur actuel. |
|
La cible actuellement affectée a été marquée comme sale. Les copies de sauvegarde des versions de fichier ne seront créées qu’après l’exécution de l’utilitaire Chkdsk . Cette valeur peut être ORed avec FH_STATE_RUNNING (0x100) pour indiquer qu’un cycle de sauvegarde est en cours d’exécution pour l’utilisateur actuel. |
|
La cible actuellement affectée ne dispose pas de suffisamment d’espace pour stocker les copies de sauvegarde des fichiers à partir de l’étendue de protection de l’historique des fichiers, et la rétention est déjà définie sur la stratégie la plus agressive. L’historique des fichiers fournit un niveau de protection dégradé. Cette valeur peut être ORed avec FH_STATE_RUNNING (0x100) pour indiquer qu’un cycle de sauvegarde est en cours d’exécution pour l’utilisateur actuel. |
|
La cible actuellement affectée ne dispose pas de suffisamment d’espace pour stocker les copies de sauvegarde des fichiers à partir de l’étendue de protection de l’historique des fichiers. L’historique des fichiers fournit un niveau de protection dégradé. Cette valeur peut être ORed avec FH_STATE_RUNNING (0x100) pour indiquer qu’un cycle de sauvegarde est en cours d’exécution pour l’utilisateur actuel. |
|
Le cache d’historique des fichiers sur l’un des disques locaux n’a pas suffisamment d’espace pour stocker temporairement des copies de sauvegarde des fichiers à partir de l’étendue de protection de l’historique des fichiers. L’historique des fichiers fournit un niveau de protection dégradé. Cette valeur peut être ORed avec FH_STATE_RUNNING (0x100) pour indiquer qu’un cycle de sauvegarde est en cours d’exécution pour l’utilisateur actuel. |
|
La cible actuellement affectée est faible sur l’espace libre et la rétention est déjà définie sur la stratégie la plus agressive. Le niveau de protection de l’historique des fichiers est susceptible de se dégrader bientôt. Cette valeur peut être ORed avec FH_STATE_RUNNING (0x100) pour indiquer qu’un cycle de sauvegarde est en cours d’exécution pour l’utilisateur actuel. |
|
La cible actuellement affectée est faible sur l’espace libre. Le niveau de protection de l’historique des fichiers est susceptible de se dégrader bientôt. Cette valeur peut être ORed avec FH_STATE_RUNNING (0x100) pour indiquer qu’un cycle de sauvegarde est en cours d’exécution pour l’utilisateur actuel. |
|
La cible actuellement affectée n’a pas été disponible pour les sauvegardes pendant une période importante, ce qui a entraîné la dégradation du niveau de protection de l’historique des fichiers. Cette valeur peut être ORed avec FH_STATE_RUNNING (0x100) pour indiquer qu’un cycle de sauvegarde est en cours d’exécution pour l’utilisateur actuel. |
|
Trop de modifications ont été apportées aux fichiers protégés ou à l’étendue de la protection. Le niveau de protection de l’historique des fichiers est susceptible de se dégrader, sauf si l’utilisateur lance explicitement une sauvegarde immédiate au lieu de s’appuyer sur des cycles de sauvegarde réguliers à effectuer en arrière-plan. Cette valeur peut être ORed avec FH_STATE_RUNNING (0x100) pour indiquer qu’un cycle de sauvegarde est en cours d’exécution pour l’utilisateur actuel. |
|
Les sauvegardes de l’historique des fichiers sont effectuées régulièrement, aucune condition d’erreur n’est détectée, un niveau optimal de protection de l’historique des fichiers est fourni. Cette valeur peut être ORed avec FH_STATE_RUNNING (0x100) pour indiquer qu’un cycle de sauvegarde est en cours d’exécution pour l’utilisateur actuel. |
[out] ProtectedUntilTime
Reçoit un pointeur vers une chaîne allouée avec SysAllocString contenant la date et l’heure jusqu’à laquelle tous les fichiers de l’étendue de protection de l’historique des fichiers sont protégés. La date et l’heure sont mises en forme en fonction des paramètres régionaux système. Si la date et l’heure sont inconnues, une chaîne vide est retournée.
Un fichier est considéré comme protégé jusqu’à un certain point dans le temps si l’une des conditions suivantes est remplie :
- Il existe une version de ce fichier qui a été capturée à ce moment-là ou après et qui a été entièrement copiée sur la cible de sauvegarde actuellement affectée.
- Le fichier a été créé ou inclus dans l’étendue de protection de l’historique des fichiers à ce stade ou après.
Valeur retournée
Si cette méthode réussit, elle retourne S_OK. Sinon, il retourne un code d’erreur HRESULT tel que l’une des valeurs définies dans le fichier d’en-tête FhErrors.h.
Notes
L’appelant est responsable de libérer la mémoire allouée pour ProtectedUntilTime en appelant SysFreeString sur celui-ci.
L’état de protection indique l’état opérationnel de l’historique des fichiers et la date et l’heure jusqu’à laquelle tous les fichiers de l’étendue de protection sont protégés.
Si la cible est complète ou déconnectée, la fonctionnalité Historique des fichiers fournit un niveau de protection dégradé comme suit :
- Les fichiers seront sauvegardés dans le cache d’historique des fichiers sur l’un des disques locaux.
- Si le cache se remplit pendant cette période, les anciennes copies sont supprimées du cache pour sauvegarder les copies plus récentes.
- Si la cible est faible en espace libre, le niveau de protection dégradé commence une fois que la cible est pleine.
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 | fhcfg.h |