Compartilhar via


Função DsSetCurrentBackupLog

[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 DsSetCurrentBackupLog define o número do log de backup atual após uma restauração bem-sucedida. Como Active Directory Domain Services dá suporte apenas ao registro em log circular, essa função normalmente não é usada.

Sintaxe

HRESULT DsSetCurrentBackupLog(
  _In_ LPCWSTR szServerName,
  _In_ DWORD   dwCurrentLog
);

Parâmetros

szServerName [in]

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do servidor para o qual definir o número do log de backup. As barras invertidas anteriores são opcionais. O servidor deve ser o mesmo computador do qual essa função é chamada. O nome do servidor não pode conter caracteres sublinhados (_). Um exemplo de nome de servidor é "\\server1".

dwCurrentLog [in]

Contém o número do log de backup a ser definido.

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 os possíveis códigos de erro.

ERROR_INVALID_PARAMETER

Um ou mais parâmetros são inválidos.

ERROR_NOT_ENOUGH_MEMORY

Ocorreu uma falha de alocação de memória.

Comentários

Normalmente, não é necessário chamar a função DsSetCurrentBackupLog . As funções de backup determinam e definem automaticamente o último número de log com backup. Use DsSetCurrentBackupLog para impedir que outro backup incremental seja bem-sucedido até que um backup completo seja executado.

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
Nomes Unicode e ANSI
DsSetCurrentBackupLogW (Unicode) e DsSetCurrentBackupLogA (ANSI)

Confira também

Fazendo backup e restaurando um servidor do Active Directory

Funções de backup de diretório