Partilhar via


Função DsBackupTruncateLogs

[Essa função está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. A partir do Windows Vista, use o VSS (Serviço de Cópias de Sombra de Volume ).

A função DsBackupTruncateLogs trunca os logs de backup lidos anteriormente.

Sintaxe

HRESULT DsBackupTruncateLogs(
  _In_ HBC hbc
);

Parâmetros

hbc [in]

Contém o identificador de contexto de backup obtido com a função DsBackupPrepare .

Valor retornado

Retorna S_OK se a função for bem-sucedida ou um código de erro Win32 ou RPC caso contrário. A lista a seguir lista outros códigos de erro possíveis.

ERROR_ACCESS_DENIED

O chamador não tem os privilégios de acesso adequados para chamar essa função. A função DsSetAuthIdentity pode ser usada para definir as credenciais a serem usadas para as funções de backup e restauração.

ERROR_INVALID_PARAMETER

hbc é inválido.

Comentários

Use a função DsBackupTruncateLogs quando um backup completo ou incremental for concluído com êxito.

Cuidado

Se essa função for chamada após um backup diferencial, todas as informações de backup incremental serão perdidas.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista
Servidor mínimo com suporte
Windows Server 2008
Cabeçalho
Ntdsbcli.h
Biblioteca
Ntdsbcli.lib
DLL
Ntdsbcli.dll

Confira também

DsBackupPrepare

DsBackupGetBackupLogs

DsSetCurrentBackupLog

Fazendo backup de um servidor do Active Directory

Funções de backup de diretório