Função DsRestorePrepare
[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 DsRestorePrepare se conecta ao servidor de diretório especificado e a prepara para a operação de restauração.
Sintaxe
HRESULT DsRestorePrepare(
_In_ LPCWSTR szServerName,
_In_ ULONG rtFlag,
_In_ PVOID pvExpiryToken,
_In_ DWORD cbExpiryTokenSize,
_Out_ HBC *phbc
);
Parâmetros
-
szServerName [in]
-
Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do servidor a ser restaurado. 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 nenhum caractere de sublinhado (_). Um exemplo de nome de servidor é "\\server1".
-
rtFlag [in]
-
Especifica o tipo de restauração a ser executada. Isso pode ser zero ou um dos valores a seguir.
-
RESTORE_TYPE_CATCHUP
-
Padrão. A versão restaurada é reconciliada por meio da lógica de reconciliação padrão para que o DIT restaurado possa ser sincronizado com outros computadores de servidor corporativo.
-
RESTORE_TYPE_AUTHORATATIVE
-
Sem suporte.
-
RESTORE_TYPE_ONLINE
-
Sem suporte. A restauração é executada quando o NTDS está online.
pvExpiryToken [in]
Ponteiro para o token de expiração associado ao backup que está sendo restaurado. Esse token foi obtido da função DsBackupPrepare quando o diretório foi feito backup.
Se esse parâmetro for NULL, o identificador retornado no phbc só poderá ser usado para obter os diretórios de restauração com a função DsRestoreGetDatabaseLocations . O identificador não pode ser usado para nenhuma outra função de restauração.
cbExpiryTokenSize [in]
Contém o tamanho, em bytes, do token de expiração em pvExpiryToken.
phbc [out]
Ponteiro para um valor HBC que recebe o identificador para a restauração. Esse identificador é usado ao chamar outras funções de restauração do Serviço de Diretório, como DsBackupOpenFile e DsRestoreEnd.
Valor retornado
Se tiver êxito, retornará um código HRESULT padrão; caso contrário, um código de falha será retornado.
Comentários
A função DsRestorePrepare exige que o chamador seja membro do grupo Administradores no servidor.
DsRestorePrepare pode ser usado com ou sem um token fornecido. Se o token for fornecido, ele será verificado quanto à expiração e todas as operações serão permitidas no contexto retornado. Se o token não for fornecido, o contexto retornado será restrito e poderá ser usado apenas para a função DsRestoreGetDatabaseLocations . Ele pode não ser usado para a função DsRestoreRegister .
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 |
DsRestorePrepareW (Unicode) e DsRestorePrepareA (ANSI) |