Share via

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

  • Artigo

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

Confira também

FhConfigMgr

IFhConfigMgr