Función DsRestoreRegister

[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 DsRestoreRegister registra una operación de restauración. Esta función interbloquea todas las operaciones de restauración posteriores e impide que el destino de restauración se inicie hasta que se llame a la función DsRestoreRegisterComplete .

Sintaxis

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]

Contiene el identificador de contexto de restauración obtenido con la función DsRestorePrepare .

szCheckPointFilePath [in]

Puntero a una cadena terminada en null que contiene la ruta de acceso al archivo de punto de comprobación. La función DsRestoreGetDatabaseLocations proporciona esta ruta de acceso y tiene un valor BFT de BFT_CHECKPOINT_DIR. Normalmente, es lo mismo que la ruta de acceso de la base de datos del sistema. Esta ruta de acceso es necesaria para una función de restauración de copia de seguridad adecuada. Este parámetro no puede ser NULL. Si se pasa NULL en este parámetro, se producirá un error durante el proceso de restauración.

szLogPath [in]

Puntero a una cadena terminada en null que contiene la ruta de acceso donde se restaurarán los archivos de registro. La función DsRestoreGetDatabaseLocations proporciona esta ruta de acceso y tiene un valor BFT de BFT_LOG_DIR. Si la ruta de acceso apunta a un directorio vacío, allí se crean nuevos archivos de registro. Este parámetro no puede ser NULL.

rgrstmap [in]

Matriz de estructuras de EDB_RSTMAP que contiene las rutas de acceso antiguas y nuevas para cada base de datos. Hay una estructura para cada base de datos. Para el directorio, hay una estructura para la base de datos del sistema y otra estructura para la base de datos de directorios. El orden de los elementos de la matriz no importa. El parámetro crstmap contiene el número de elementos de la matriz.

crstmap [in]

Contiene el número de elementos de la matriz rgrstmap .

szBackupLogPath [in]

Puntero a una cadena terminada en null que contiene la ruta de acceso en la que residen actualmente los archivos de registro de copia de seguridad. Este parámetro no puede ser NULL.

genLow [in]

Contiene el número de registro más bajo para restaurar en esta sesión de restauración. Se trata de un número hexadecimal en el intervalo de 0x00000 a 0xFFFFF.

genHigh [in]

Contiene el número de registro más alto para restaurar en esta sesión de restauración. Se trata de un número hexadecimal en el intervalo de 0x00000 a 0xFFFFF.

Valor devuelto

Devuelve S_OK si la función es correcta o un código de error Win32 o RPC en caso contrario. En la lista siguiente se enumeran los posibles códigos de error.

ERROR_ACCESS_DENIED

El autor de la llamada no tiene los privilegios de acceso adecuados para llamar a esta función. La función DsSetAuthIdentity se puede usar para establecer las credenciales que se usarán para las funciones de copia de seguridad y restauración.

ERROR_INVALID_PARAMETER

Uno o varios parámetros no son válidos.

hrMissingExpiryToken

El token de expiración proporcionado a DsRestorePrepare no era válido. Este valor se define en Ntdsbmsg.h.

Requisitos

Consulte también

DsRestoreRegisterComplete

DsRestorePrepare

DsRestoreGetDatabaseLocations

DsRestoreEnd

EDB_RSTMAP

Restauración de Active Directory

Funciones de copia de seguridad de directorios