Função FhServiceStartBackup (fhsvcctl.h)
Essa função inicia um backup imediato para o usuário atual.
Observação
FhServiceStartBackup foi preterido e pode ser alterado ou indisponível em versões futuras.
Sintaxe
HRESULT FhServiceStartBackup(
[in] FH_SERVICE_PIPE_HANDLE Pipe,
[in] BOOL LowPriorityIo
);
Parâmetros
[in] Pipe
O identificador do canal de comunicação retornado por uma chamada FhServiceOpenPipe anterior.
[in] LowPriorityIo
Se TRUE, o Serviço de Histórico de Arquivos será instruído a usar E/S de baixa prioridade para o backup imediato agendado por essa função. A E/S de baixa prioridade reduz o impacto nas atividades do usuário em primeiro plano. É recomendável definir esse parâmetro como TRUE.
Se FALSE, o Serviço de Histórico de Arquivos será instruído a usar a E/S de prioridade normal para o backup imediato agendado por essa função. Isso resulta em backups mais rápidos, mas afeta negativamente a capacidade de resposta e o desempenho dos aplicativos de usuário.
Valor retornado
S_OK sobre o sucesso ou um HRESULT malsucedido em caso de falha. Possíveis valores HRESULT malsucedidos incluem valores definidos no arquivo de cabeçalho FhErrors.h.
Comentários
Essa função não aguarda até que o backup imediato seja concluído. Se uma condição de erro ou aviso for encontrada durante o backup, ela será comunicada ao usuário por meio de uma notificação da Central de Ações e recuperável programaticamente por meio do método IFhConfigMgr::QueryProtectionStatus .
Um ciclo de backup iniciado chamando essa função pode ser interrompido usando a função FhServiceStopBackup .
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 | fhsvcctl.h |
Biblioteca | FhSvcCtl.lib |