Função DsBackupGetBackupLogs
[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 DsBackupGetBackupLogs obtém a lista de arquivos de log que devem ser copiados em backup para o contexto de backup fornecido.
Sintaxe
HRESULT DsBackupGetBackupLogs(
_In_ HBC hbc,
_Out_ LPTSTR *pszBackupLogFiles,
_Out_ LPDWORD pcbSize
);
Parâmetros
-
hbc [in]
-
Contém o identificador de contexto de backup obtido com a função DsBackupPrepare .
-
pszBackupLogFiles [out]
-
Ponteiro para um ponteiro de cadeia de caracteres que recebe a lista de nomes de arquivo de log como caminhos UNC. Inicialize esse valor para NULL antes de chamar DsBackupGetBackupLogs.
Essa lista recebe uma lista dupla terminada em nulo de cadeias de caracteres terminadas em nulo único.
Esse buffer é alocado pela função DsBackupGetBackupLogs e deve ser liberado quando não for mais necessário chamando a função DsBackupFree .
O primeiro caractere de cada um dos nomes de arquivo contém uma das Constantes BFT que identifica o tipo de nome.
-
pcbSize [out]
-
Ponteiro para o valor DWORD que recebe o tamanho, em bytes, do buffer pszBackupLogFiles .
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, pszBackupLogFiles ou pcbSize é inválido.
-
ERROR_NOT_ENOUGH_MEMORY
-
Ocorreu uma falha de alocação de memória.
Comentários
A função DsBackupGetBackupLogs fornece uma lista dos arquivos de log necessários para um backup. Um backup completo consiste nos arquivos de banco de dados fornecidos pela função DsBackupGetDatabaseNames e pelos arquivos de log. Não há suporte para backups incrementais de servidores do Active Directory.
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 |
DsBackupGetBackupLogsW (Unicode) e DsBackupGetBackupLogsA (ANSI) |