Partager via

Méthode IFhConfigMgr::QueryProtectionStatus (fhcfg.h)

  • Article

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
FH_STATE_NOT_TRACKED
0x00
 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).
FH_STATE_OFF
0x01
 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).
FH_STATE_DISABLED_BY_GP
0x02
 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).
FH_STATE_FATAL_CONFIG_ERROR
0x03
 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).
FH_STATE_TARGET_ACCESS_DENIED
0x0E
 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.
FH_STATE_TARGET_VOLUME_DIRTY
0x0F
 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.
FH_STATE_TARGET_FULL_RETENTION_MAX
0x10
 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.
FH_STATE_TARGET_FULL
0x11
 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.
FH_STATE_STAGING_FULL
0x12
 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.
FH_STATE_TARGET_LOW_SPACE_RETENTION_MAX
0x13
 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.
FH_STATE_TARGET_LOW_SPACE
0x14
 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.
FH_STATE_TARGET_ABSENT
0x15
 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.
FH_STATE_TOO_MUCH_BEHIND
0x16
 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.
FH_STATE_NO_ERROR
0xFF
 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

Voir aussi

FhConfigMgr

IFhConfigMgr