Compartir a través de


Función DsRestorePrepare

[Esta función está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. A partir de Windows Vista, use el Servicio de instantáneas de volumen (VSS) en su lugar.

La función DsRestorePrepare se conecta al servidor de directorios especificado y la prepara para la operación de restauración.

Sintaxis

HRESULT DsRestorePrepare(
  _In_  LPCWSTR szServerName,
  _In_  ULONG   rtFlag,
  _In_  PVOID   pvExpiryToken,
  _In_  DWORD   cbExpiryTokenSize,
  _Out_ HBC     *phbc
);

Parámetros

szServerName [in]

Puntero a una cadena terminada en null que contiene el nombre del servidor que se va a restaurar. Las barras diagonales inversas anteriores son opcionales. El servidor debe ser el mismo equipo desde el que se llama a esta función. El nombre del servidor no puede contener caracteres de subrayado (_). Un ejemplo de un nombre de servidor es "\\server1".

rtFlag [in]

Especifica el tipo de restauración que se va a realizar. Puede ser cero o uno de los valores siguientes.

RESTORE_TYPE_CATCHUP

Predeterminada. La versión restaurada se reconcilia a través de la lógica de conciliación estándar para que el DIT restaurado pueda sincronizarse con otros equipos de servidor empresarial.

RESTORE_TYPE_AUTHORATATIVE

No compatible.

RESTORE_TYPE_ONLINE

No compatible. La restauración se realiza cuando NTDS está en línea.

pvExpiryToken [in]

Puntero al token de expiración asociado a la copia de seguridad que se va a restaurar. Este token se obtuvo de la función DsBackupPrepare cuando se realizó una copia de seguridad del directorio.

Si este parámetro es NULL, el identificador devuelto en phbc solo se puede usar para obtener los directorios de restauración con la función DsRestoreGetDatabaseLocations . El identificador no se puede usar para ninguna otra función de restauración.

cbExpiryTokenSize [in]

Contiene el tamaño, en bytes, del token de expiración en pvExpiryToken.

phbc [out]

Puntero a un valor HBC que recibe el identificador de la restauración. Este identificador se usa al llamar a otras funciones de restauración del servicio de directorio, como DsBackupOpenFile y DsRestoreEnd.

Valor devuelto

Si se ejecuta correctamente, devuelve un código HRESULT estándar; De lo contrario, se devuelve un código de error.

Observaciones

La función DsRestorePrepare requiere que el autor de la llamada sea miembro del grupo Administradores en el servidor.

DsRestorePrepare se puede usar con o sin un token proporcionado. Si se proporciona el token, se comprueba la expiración y se permiten todas las operaciones en el contexto devuelto. Si no se proporciona el token, el contexto devuelto está restringido y solo se puede usar para la función DsRestoreGetDatabaseLocations . Es posible que no se use para la función DsRestoreRegister .

Requisitos

Requisito Value
Cliente mínimo compatible
Windows Vista
Servidor mínimo compatible
Windows Server 2008
Encabezado
Ntdsbcli.h
Biblioteca
Ntdsbcli.lib
Archivo DLL
Ntdsbcli.dll
Nombres Unicode y ANSI
DsRestorePrepareW (Unicode) y DsRestorePrepareA (ANSI)

Consulte también

Restauración de un servidor de Active Directory

Funciones de copia de seguridad de directorio

DsRestoreGetDatabaseLocations

DsRestoreRegister

DsRestoreRegisterComplete

DsRestoreEnd