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

Confira também

FhServiceOpenPipe

FhServiceStopBackup

IFhConfigMgr::QueryProtectionStatus