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