Função FhServiceBlockBackup (fhsvcctl.h)

Essa função bloqueia temporariamente os backups para o usuário atual.

Observação

FhServiceBlockBackup foi preterido e pode ser alterado ou indisponível em versões futuras.

Sintaxe

HRESULT FhServiceBlockBackup(
  [in] FH_SERVICE_PIPE_HANDLE Pipe
);

Parâmetros

[in] Pipe

O identificador do canal de comunicação retornado por uma chamada FhServiceOpenPipe anterior.

Valor retornado

S_OK em caso de êxito ou um valor 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 instrui o Serviço de Histórico de Arquivos a não executar backups para o usuário atual até que a função FhServiceUnblockBackup seja chamada ou o canal de comunicação com o Serviço de Histórico de Arquivos seja fechado chamando FhServiceClosePipe.

Chame essa função antes de executar a reassociação da configuração do Histórico de Arquivos para garantir que a configuração do Histórico de Arquivos e os arquivos de dados não estejam em uso no momento. (Caso contrário, o método IFhReassociation::P erformReassociation poderá falhar.)

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

FhServiceClosePipe

FhServiceOpenPipe

FhServiceUnblockBackup

IFhReassociation::P erformReassociation