Função DsBackupGetDatabaseNames
[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 DsBackupGetDatabaseNames obtém a lista de arquivos de banco de dados a serem copiados em backup para o contexto de backup fornecido.
Sintaxe
HRESULT DsBackupGetDatabaseNames(
_In_ HBC hbc,
_Out_ LPTSTR *pszAttachmentInfo,
_Out_ LPDWORD pcbSize
);
Parâmetros
-
hbc [in]
-
Contém o identificador de contexto de backup obtido com a função DsBackupPrepare .
-
pszAttachmentInfo [out]
-
Ponteiro para um ponteiro de cadeia de caracteres que recebe a lista de nomes de arquivo de banco de dados como caminhos UNC. Esse valor deve ser inicializado como NULL antes de chamar DsBackupGetDatabaseNames.
Essa lista recebe uma lista dupla terminada em nulo de cadeias de caracteres terminadas em nulo único.
Esse buffer é alocado pela função DsBackupGetDatabaseNames e deve ser liberado quando não for mais necessário chamando a função DsBackupFree .
O primeiro caractere de cada nome de arquivo contém uma das Constantes BFT que identifica o tipo de nome. A função DsRestoreGetDatabaseLocations fornece apenas os seguintes tipos de nomes.
-
BFT_NTDS_DATABASE
-
O arquivo é um arquivo de banco de dados NTDS. Esse arquivo deve ser copiado para o arquivo identificado como BFT_NTDS_DATABASE quando os dados são restaurados.
-
BFT_LOG
-
O arquivo é um arquivo de log. Todos os arquivos de log são copiados para o diretório identificado como BFT_LOG_DIR quando os dados são restaurados.
-
BFT_PATCH_FILE
-
O arquivo é um arquivo de patch. Todos os arquivos de patch são copiados para o diretório identificado como BFT_CHECKPOINT_DIR quando os dados são restaurados.
pcbSize [out]
Ponteiro para o valor DWORD que recebe o tamanho, em bytes, do buffer pszAttachmentInfo .
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, pszAttachmentInfo ou pcbSize são inválidos.
-
ERROR_NOT_ENOUGH_MEMORY
-
Ocorreu uma falha de alocação de memória.
Comentários
A função DsBackupGetDatabaseNames fornece uma lista dos arquivos de banco de dados necessários para um backup. Um backup completo consiste nos arquivos de banco de dados e nos arquivos de log fornecidos pela função DsBackupGetBackupLogs . 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 |
DsBackupGetDatabaseNamesW (Unicode) e DsBackupGetDatabaseNamesA (ANSI) |