Função DsRestoreRegister
[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ópia de Sombra de Volume).
A função DsRestoreRegister registra uma operação de restauração. Essa função intercala todas as operações de restauração subsequentes e impede que o destino de restauração seja iniciado até que a função DsRestoreRegisterComplete seja chamada.
Sintaxe
HRESULT DsRestoreRegister(
_In_ HBC hbc,
_In_ LPCTSTR szCheckPointFilePath,
_In_ LPCTSTR szLogPath,
_In_ EDB_RSTMAP rgrstmap[],
_In_ LONG crstmap,
_In_ LPCTSTR szBackupLogPath,
_In_ ULONG genLow,
_In_ ULONG genHigh
);
Parâmetros
-
hbc [in]
-
Contém o identificador de contexto de restauração obtido com a função DsRestorePrepare .
-
szCheckPointFilePath [in]
-
Ponteiro para uma cadeia de caracteres terminada em nulo que contém o caminho para o arquivo de ponto de verificação. Esse caminho é fornecido pela função DsRestoreGetDatabaseLocations e tem um valor BFT de BFT_CHECKPOINT_DIR. Normalmente, isso é o mesmo que o caminho do banco de dados do sistema. Esse caminho é necessário para a função de restauração de backup adequada. Esse parâmetro não pode ser NULL. Passar NULL nesse parâmetro causará um erro durante o processo de restauração.
-
szLogPath [in]
-
Ponteiro para uma cadeia de caracteres terminada em nulo que contém o caminho em que os arquivos de log serão restaurados. Esse caminho é fornecido pela função DsRestoreGetDatabaseLocations e tem um valor BFT de BFT_LOG_DIR. Se o caminho apontar para um diretório vazio, novos arquivos de log serão criados lá. Esse parâmetro não pode ser NULL.
-
rgrstmap [in]
-
Uma matriz de estruturas EDB_RSTMAP que contém os caminhos antigos e novos para cada banco de dados. Há uma estrutura para cada banco de dados. Para o diretório, há uma estrutura para o banco de dados do sistema e outra estrutura para o banco de dados de diretório. A ordem dos elementos na matriz não importa. O parâmetro crstmap contém o número de elementos na matriz.
-
crstmap [in]
-
Contém o número de elementos na matriz rgrstmap .
-
szBackupLogPath [in]
-
Ponteiro para uma cadeia de caracteres terminada em nulo que contém o caminho em que os arquivos de log de backup residem atualmente. Esse parâmetro não pode ser NULL.
-
genLow [in]
-
Contém o número de log mais baixo a ser restaurado nesta sessão de restauração. Esse é um número hexadecimal no intervalo de 0x00000 a 0xFFFFF.
-
genHigh [in]
-
Contém o número de log mais alto a ser restaurado nesta sessão de restauração. Esse é um número hexadecimal no intervalo de 0x00000 a 0xFFFFF.
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_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
-
Um ou mais parâmetros são inválidos.
-
hrMissingExpiryToken
-
O token de expiração fornecido a DsRestorePrepare era inválido. Esse valor é definido em Ntdsbmsg.h.
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 |
DsRestoreRegisterW (Unicode) e DsRestoreRegisterA (ANSI) |