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 |
|
Biblioteca |
|
Archivo DLL |
|
Nombres Unicode y ANSI |
DsRestorePrepareW (Unicode) y DsRestorePrepareA (ANSI) |