Metodo IFhConfigMgr::QueryProtectionStatus (fhcfg.h)
Recupera lo stato di protezione della cronologia file corrente.
Nota
IFhConfigMgr è deprecato e può essere modificato o non disponibile nelle versioni future.
Sintassi
HRESULT QueryProtectionStatus(
[out] DWORD *ProtectionState,
[out] BSTR *ProtectedUntilTime
);
Parametri
[out] ProtectionState
Al ritorno, questo parametro riceve lo stato di protezione cronologia file corrente. Gli stati di protezione seguenti sono definiti nel file di intestazione FhStatus.h.
| Valore | Significato |
|---|---|
|
Lo stato di protezione cronologia file è sconosciuto, perché il servizio Cronologia file non viene avviato o l'utente corrente non viene monitorato. Questo valore non può essere ORed con FH_STATE_RUNNING (0x100 ). |
|
La protezione cronologia file non è abilitata per l'utente corrente. Nessun file verrà eseguito il backup. Questo valore non può essere ORed con FH_STATE_RUNNING (0x100 ). |
|
La protezione cronologia file è disabilitata da Criteri di gruppo. Nessun file verrà eseguito il backup. Questo valore non può essere ORed con FH_STATE_RUNNING (0x100 ). |
|
Si verifica un errore irreversibile in uno dei file che archivia le informazioni interne sulla cronologia file per l'utente corrente. Nessun file verrà eseguito il backup. Questo valore non può essere ORed con FH_STATE_RUNNING (0x100 ). |
|
L'utente corrente non dispone dell'autorizzazione di scrittura per la destinazione attualmente assegnata. Le copie di backup delle versioni di file non verranno create. Questo valore può essere ORed con FH_STATE_RUNNING (0x100 ) per indicare che un ciclo di backup viene eseguito per l'utente corrente. |
|
La destinazione attualmente assegnata è stata contrassegnata come sporca. Le copie di backup delle versioni di file non verranno create fino a quando non viene eseguita l'utilità Chkdsk . Questo valore può essere ORed con FH_STATE_RUNNING (0x100 ) per indicare che un ciclo di backup viene eseguito per l'utente corrente. |
|
La destinazione attualmente assegnata non dispone di spazio sufficiente per archiviare copie di backup di file dall'ambito protezione cronologia file e la conservazione è già impostata sui criteri più aggressivi. La cronologia dei file fornisce un livello di protezione danneggiato. Questo valore può essere ORed con FH_STATE_RUNNING (0x100 ) per indicare che un ciclo di backup viene eseguito per l'utente corrente. |
|
La destinazione attualmente assegnata non dispone di spazio sufficiente per archiviare copie di backup di file dall'ambito protezione cronologia file. La cronologia dei file fornisce un livello di protezione danneggiato. Questo valore può essere ORed con FH_STATE_RUNNING (0x100 ) per indicare che un ciclo di backup viene eseguito per l'utente corrente. |
|
La cache Cronologia file in uno dei dischi locali non ha spazio sufficiente per archiviare temporaneamente copie di backup di file dall'ambito di protezione Cronologia file. La cronologia dei file fornisce un livello di protezione danneggiato. Questo valore può essere ORed con FH_STATE_RUNNING (0x100 ) per indicare che un ciclo di backup viene eseguito per l'utente corrente. |
|
La destinazione attualmente assegnata è in esecuzione bassa sullo spazio libero e la conservazione è già impostata sui criteri più aggressivi. Il livello di protezione della cronologia dei file è probabilmente degradato presto. Questo valore può essere ORed con FH_STATE_RUNNING (0x100 ) per indicare che un ciclo di backup viene eseguito per l'utente corrente. |
|
La destinazione attualmente assegnata è in esecuzione bassa sullo spazio libero. Il livello di protezione della cronologia dei file è probabilmente degradato presto. Questo valore può essere ORed con FH_STATE_RUNNING (0x100 ) per indicare che un ciclo di backup viene eseguito per l'utente corrente. |
|
La destinazione attualmente assegnata non è stata disponibile per i backup per un periodo di tempo significativo, causando l'avvio della riduzione del livello di protezione della cronologia dei file. Questo valore può essere ORed con FH_STATE_RUNNING (0x100 ) per indicare che un ciclo di backup viene eseguito per l'utente corrente. |
|
Troppe modifiche sono state apportate nei file protetti o nell'ambito di protezione. Il livello di protezione della cronologia dei file è probabilmente degradato, a meno che l'utente non avvia in modo esplicito un backup immediato anziché basarsi su cicli di backup regolari da eseguire in background. Questo valore può essere ORed con FH_STATE_RUNNING (0x100 ) per indicare che un ciclo di backup viene eseguito per l'utente corrente. |
|
I backup della cronologia file vengono eseguiti regolarmente, non vengono rilevate condizioni di errore, viene fornito un livello ottimale di protezione cronologia file. Questo valore può essere ORed con FH_STATE_RUNNING (0x100 ) per indicare che un ciclo di backup viene eseguito per l'utente corrente. |
[out] ProtectedUntilTime
Riceve un puntatore a una stringa allocata con SysAllocString contenente la data e l'ora fino a quando tutti i file all'interno dell'ambito di protezione cronologia file sono protetti. La data e l'ora vengono formattate per le impostazioni locali del sistema. Se la data e l'ora sono sconosciute, viene restituita una stringa vuota.
Un file viene considerato protetto fino a un determinato momento se una delle condizioni seguenti è true:
- C'è una versione del file che è stata acquisita in corrispondenza o dopo quel momento e che è stata completamente copiata nella destinazione di backup attualmente assegnata prima di ora.
- Il file è stato creato o incluso nell'ambito protezione cronologia file in corrispondenza o dopo tale momento.
Valore restituito
Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT , ad esempio uno dei valori definiti nel file di intestazione FhErrors.h.
Commenti
Il chiamante è responsabile del rilascio della memoria allocata per ProtectedUntilTime chiamando SysFreeString su di esso.
Lo stato di protezione indica lo stato operativo Cronologia file e la data e l'ora fino a quando tutti i file all'interno dell'ambito di protezione sono protetti.
Se la destinazione è completa o disconnessa, la funzionalità Cronologia file fornirà un livello di protezione danneggiato come indicato di seguito:
- I file verranno sottoposti a backup nella cache Cronologia file in uno dei dischi locali.
- Se la cache viene riempita durante questo periodo, le copie precedenti verranno eliminate dalla cache per eseguire il backup di copie più recenti.
- Se la destinazione è bassa sullo spazio libero, il livello di protezione danneggiato inizierà una volta che la destinazione diventa piena.
Requisiti
| Client minimo supportato | Windows 8 [solo app desktop] |
| Server minimo supportato | Windows Server 2012 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | fhcfg.h |