Método IFhConfigMgr::QueryProtectionStatus (fhcfg.h)
Recupera el estado de protección actual del historial de archivos.
Nota:
IFhConfigMgr está en desuso y puede modificarse o no estar disponible en futuras versiones.
Sintaxis
HRESULT QueryProtectionStatus(
[out] DWORD *ProtectionState,
[out] BSTR *ProtectedUntilTime
);
Parámetros
[out] ProtectionState
A cambio, este parámetro recibe el estado de protección actual del historial de archivos. Los siguientes estados de protección se definen en el archivo de encabezado FhStatus.h.
| Valor | Significado |
|---|---|
|
El estado de protección del historial de archivos es desconocido, ya que el servicio Historial de archivos no se inicia o no se realiza el seguimiento del usuario actual en él. Este valor no puede ser ORed con FH_STATE_RUNNING (0x100). |
|
La protección del historial de archivos no está habilitada para el usuario actual. No se realizará una copia de seguridad de ningún archivo. Este valor no puede ser ORed con FH_STATE_RUNNING (0x100). |
|
La protección del historial de archivos está deshabilitada por directiva de grupo. No se realizará una copia de seguridad de ningún archivo. Este valor no puede ser ORed con FH_STATE_RUNNING (0x100). |
|
Hay un error irrecuperable en uno de los archivos que almacenan información interna del historial de archivos para el usuario actual. No se realizará una copia de seguridad de ningún archivo. Este valor no puede ser ORed con FH_STATE_RUNNING (0x100). |
|
El usuario actual no tiene permiso de escritura para el destino asignado actualmente. No se crearán copias de seguridad de las versiones de archivo. Este valor puede ser ORed con FH_STATE_RUNNING (0x100) para indicar que se está realizando un ciclo de copia de seguridad para el usuario actual en este momento. |
|
El destino asignado actualmente se ha marcado como sucio. Las copias de seguridad de las versiones de archivo no se crearán hasta que se ejecute la utilidad Chkdsk . Este valor puede ser ORed con FH_STATE_RUNNING (0x100) para indicar que se está realizando un ciclo de copia de seguridad para el usuario actual en este momento. |
|
El destino asignado actualmente no tiene espacio suficiente para almacenar copias de seguridad de archivos desde el ámbito de protección historial de archivos y la retención ya está establecida en la directiva más agresiva. El historial de archivos proporcionará un nivel de protección degradado. Este valor puede ser ORed con FH_STATE_RUNNING (0x100) para indicar que se está realizando un ciclo de copia de seguridad para el usuario actual en este momento. |
|
El destino asignado actualmente no tiene espacio suficiente para almacenar copias de seguridad de archivos desde el ámbito de protección historial de archivos. El historial de archivos proporcionará un nivel de protección degradado. Este valor puede ser ORed con FH_STATE_RUNNING (0x100) para indicar que se está realizando un ciclo de copia de seguridad para el usuario actual en este momento. |
|
La memoria caché del historial de archivos en uno de los discos locales no tiene espacio suficiente para almacenar copias de seguridad de archivos desde el ámbito de protección historial de archivos temporalmente. El historial de archivos proporcionará un nivel de protección degradado. Este valor puede ser ORed con FH_STATE_RUNNING (0x100) para indicar que se está realizando un ciclo de copia de seguridad para el usuario actual en este momento. |
|
El destino asignado actualmente se está ejecutando poco en el espacio libre y la retención ya está establecida en la directiva más agresiva. Es probable que el nivel de protección del historial de archivos se degrade pronto. Este valor puede ser ORed con FH_STATE_RUNNING (0x100) para indicar que se está realizando un ciclo de copia de seguridad para el usuario actual en este momento. |
|
El destino asignado actualmente se está ejecutando poco en el espacio libre. Es probable que el nivel de protección del historial de archivos se degrade pronto. Este valor puede ser ORed con FH_STATE_RUNNING (0x100) para indicar que se está realizando un ciclo de copia de seguridad para el usuario actual en este momento. |
|
El destino asignado actualmente no está disponible para las copias de seguridad durante un período de tiempo considerable, lo que hace que el nivel de protección del historial de archivos empiece a degradarse. Este valor puede ser ORed con FH_STATE_RUNNING (0x100) para indicar que se está realizando un ciclo de copia de seguridad para el usuario actual en este momento. |
|
Se han realizado demasiados cambios en los archivos protegidos o en el ámbito de protección. Es probable que el nivel de protección del historial de archivos se degrade, a menos que el usuario inicie explícitamente una copia de seguridad inmediata en lugar de depender de ciclos de copia de seguridad normales que se realicen en segundo plano. Este valor puede ser ORed con FH_STATE_RUNNING (0x100) para indicar que se está realizando un ciclo de copia de seguridad para el usuario actual en este momento. |
|
Las copias de seguridad del historial de archivos se realizan con regularidad, no se detectan condiciones de error, se proporciona un nivel óptimo de protección del historial de archivos. Este valor puede ser ORed con FH_STATE_RUNNING (0x100) para indicar que se está realizando un ciclo de copia de seguridad para el usuario actual en este momento. |
[out] ProtectedUntilTime
Recibe un puntero a una cadena asignada con SysAllocString que contiene la fecha y hora hasta que todos los archivos del ámbito de protección historial de archivos están protegidos. La fecha y hora tienen el formato según la configuración regional del sistema. Si se desconoce la fecha y hora, se devuelve una cadena vacía.
Un archivo se considera protegido hasta un momento dado si se cumple una de las condiciones siguientes:
- Hay una versión de ese archivo que se capturó en ese momento o después de ese momento y se copió completamente en el destino de copia de seguridad asignado actualmente antes.
- El archivo se creó o incluyó en el ámbito de protección historial de archivos en ese momento o después de ese momento.
Valor devuelto
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT , como uno de los valores definidos en el archivo de encabezado FhErrors.h.
Comentarios
El autor de la llamada es responsable de liberar la memoria asignada para ProtectedUntilTime mediante una llamada a SysFreeString en él.
El estado de protección indica el estado operativo historial de archivos y la fecha y hora hasta que todos los archivos del ámbito de protección están protegidos.
Si el destino está lleno o desconectado, la característica Historial de archivos proporcionará un nivel de protección degradado como se indica a continuación:
- Se realizará una copia de seguridad de los archivos en la memoria caché del historial de archivos en uno de los discos locales.
- Si la memoria caché se rellena durante este tiempo, las copias anteriores se eliminarán de la memoria caché para realizar copias de seguridad de las copias más recientes.
- Si el destino es bajo en el espacio libre, el nivel degradado de protección se iniciará una vez que el destino se llena.
Requisitos
| Cliente mínimo compatible | Windows 8 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2012 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | fhcfg.h |