Método IFhConfigMgr::QueryProtectionStatus (fhcfg.h)
Recupera o estado atual de proteção do Histórico de Arquivos.
Observação
IFhConfigMgr foi preterido e pode ser alterado ou indisponível em versões futuras.
Sintaxe
HRESULT QueryProtectionStatus(
[out] DWORD *ProtectionState,
[out] BSTR *ProtectedUntilTime
);
Parâmetros
[out] ProtectionState
No retorno, esse parâmetro recebe o estado atual de proteção do Histórico de Arquivos. Os seguintes estados de proteção são definidos no arquivo de cabeçalho FhStatus.h.
| Valor | Significado |
|---|---|
|
O estado de proteção do Histórico de Arquivos é desconhecido, pois o serviço de Histórico de Arquivos não foi iniciado ou o usuário atual não é rastreado nele. Esse valor não pode ser ORed com FH_STATE_RUNNING (0x100). |
|
A proteção do Histórico de Arquivos não está habilitada para o usuário atual. Nenhum arquivo será feito em backup. Esse valor não pode ser ORed com FH_STATE_RUNNING (0x100). |
|
A proteção do Histórico de Arquivos é desabilitada por Política de Grupo. Nenhum arquivo será feito em backup. Esse valor não pode ser ORed com FH_STATE_RUNNING (0x100). |
|
Há um erro fatal em um dos arquivos que armazenam informações internas do Histórico de Arquivos para o usuário atual. Nenhum arquivo será feito em backup. Esse valor não pode ser ORed com FH_STATE_RUNNING (0x100). |
|
O usuário atual não tem permissão de gravação para o destino atribuído no momento. Cópias de backup de versões de arquivo não serão criadas. Esse valor pode ser ORed com FH_STATE_RUNNING (0x100) para indicar que um ciclo de backup está sendo executado para o usuário atual no momento. |
|
O destino atribuído no momento foi marcado como sujo. Cópias de backup de versões de arquivo não serão criadas até que o utilitário Chkdsk seja executado. Esse valor pode ser ORed com FH_STATE_RUNNING (0x100) para indicar que um ciclo de backup está sendo executado para o usuário atual no momento. |
|
O destino atribuído no momento não tem espaço suficiente para armazenar cópias de backup de arquivos do escopo de proteção do Histórico de Arquivos e a retenção já está definida como a política mais agressiva. O Histórico de Arquivos fornecerá um nível degradado de proteção. Esse valor pode ser ORed com FH_STATE_RUNNING (0x100) para indicar que um ciclo de backup está sendo executado para o usuário atual no momento. |
|
O destino atribuído no momento não tem espaço suficiente para armazenar cópias de backup de arquivos do escopo de proteção do Histórico de Arquivos. O Histórico de Arquivos fornecerá um nível degradado de proteção. Esse valor pode ser ORed com FH_STATE_RUNNING (0x100) para indicar que um ciclo de backup está sendo executado para o usuário atual no momento. |
|
O cache de Histórico de Arquivos em um dos discos locais não tem espaço suficiente para armazenar cópias de backup de arquivos do escopo de proteção do Histórico de Arquivos temporariamente. O Histórico de Arquivos fornecerá um nível degradado de proteção. Esse valor pode ser ORed com FH_STATE_RUNNING (0x100) para indicar que um ciclo de backup está sendo executado para o usuário atual no momento. |
|
O destino atribuído no momento está com pouco espaço livre e a retenção já está definida como a política mais agressiva. O nível de proteção do Histórico de Arquivos provavelmente será degradado em breve. Esse valor pode ser ORed com FH_STATE_RUNNING (0x100) para indicar que um ciclo de backup está sendo executado para o usuário atual no momento. |
|
O destino atribuído no momento está com pouco espaço livre. O nível de proteção do Histórico de Arquivos provavelmente será degradado em breve. Esse valor pode ser ORed com FH_STATE_RUNNING (0x100) para indicar que um ciclo de backup está sendo executado para o usuário atual no momento. |
|
O destino atribuído no momento não está disponível para backups por um período substancial de tempo, fazendo com que o nível de proteção do Histórico de Arquivos comece a ser degradado. Esse valor pode ser ORed com FH_STATE_RUNNING (0x100) para indicar que um ciclo de backup está sendo executado para o usuário atual no momento. |
|
Muitas alterações foram feitas nos arquivos protegidos ou no escopo de proteção. É provável que o nível de proteção do Histórico de Arquivos seja degradado, a menos que o usuário inicie explicitamente um backup imediato em vez de depender de ciclos de backup regulares a serem executados em segundo plano. Esse valor pode ser ORed com FH_STATE_RUNNING (0x100) para indicar que um ciclo de backup está sendo executado para o usuário atual no momento. |
|
Os backups de Histórico de Arquivos são executados regularmente, nenhuma condição de erro é detectada, um nível ideal de proteção do Histórico de Arquivos é fornecido. Esse valor pode ser ORed com FH_STATE_RUNNING (0x100) para indicar que um ciclo de backup está sendo executado para o usuário atual no momento. |
[out] ProtectedUntilTime
Recebe um ponteiro para uma cadeia de caracteres alocada com SysAllocString que contém a data e a hora até que todos os arquivos dentro do escopo de proteção do Histórico de Arquivos sejam protegidos. A data e a hora são formatadas de acordo com a localidade do sistema. Se a data e a hora forem desconhecidas, uma cadeia de caracteres vazia será retornada.
Um arquivo é considerado protegido até um determinado ponto no tempo se uma das seguintes condições for verdadeira:
- Há uma versão desse arquivo que foi capturada em ou depois desse ponto no tempo e foi totalmente copiada para o destino de backup atribuído no momento antes.
- O arquivo foi criado ou incluído no escopo de proteção do Histórico de Arquivos em ou depois desse ponto no tempo.
Retornar valor
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT , como um dos valores definidos no arquivo de cabeçalho FhErrors.h.
Comentários
O chamador é responsável por liberar a memória alocada para ProtectedUntilTime chamando SysFreeString nela.
O estado de proteção indica o estado operacional do Histórico de Arquivos e a data e hora até que todos os arquivos dentro do escopo de proteção estejam protegidos.
Se o destino estiver cheio ou desconectado, o recurso Histórico de Arquivos fornecerá um nível degradado de proteção da seguinte maneira:
- Os arquivos serão armazenados em backup no cache de Histórico de Arquivos em um dos discos locais.
- Se o cache for preenchido durante esse tempo, as cópias mais antigas serão excluídas do cache para fazer backup de cópias mais recentes.
- Se o destino estiver com pouco espaço livre, o nível degradado de proteção será iniciado quando o destino ficar cheio.
Requisitos
| Cliente mínimo com suporte | Windows 8 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2012 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | fhcfg.h |