Función CertSrvRestoreRegisterThroughFile (certbcli.h)

La función CertSrvRestoreRegisterThroughFile registra una restauración de Servicios de certificados.

Sintaxis

HRESULT CERTBCLI_API CertSrvRestoreRegisterThroughFile(
  [in]           HCSBC            hbc,
  [in, optional] WCHAR const      *pwszCheckPointFilePath,
  [in, optional] WCHAR const      *pwszLogPath,
  [in, optional] CSEDB_RSTMAPW [] rgrstmap,
  [in]           LONG             crstmap,
  [in, optional] WCHAR const      *pwszBackupLogPath,
  [in]           ULONG            genLow,
  [in]           ULONG            genHigh
);

Parámetros

[in] hbc

Identificador del contexto de restauración de Servicios de certificados. Este identificador se obtiene mediante una llamada a la función CertSrvRestorePrepare .

[in, optional] pwszCheckPointFilePath

Puntero a una cadena Unicode terminada en null que contiene la ruta de acceso de restauración para el archivo de punto de comprobación. Pase NULL para este parámetro si no es necesario.

[in, optional] pwszLogPath

Puntero a una cadena Unicode terminada en null que contiene el directorio del archivo de registro actual. Pase NULL para este parámetro si no es necesario.

[in, optional] rgrstmap

Matriz de estructuras de CSEDB_RSTMAP que contiene el mapa de restauración. Si va a realizar una restauración completa de la base de datos, este parámetro especifica el nombre de la base de datos de copia de seguridad, así como un nuevo nombre para la base de datos después de restaurarla. El miembro pwszDatabaseName hace referencia al nombre de la base de datos de copia de seguridad y el miembro pwszNewDatabaseName hace referencia al nuevo nombre de la base de datos. Si la intención es mantener el mismo nombre para la base de datos de copia de seguridad y la base de datos restaurada, establezca los miembros pwszNewDatabaseName y pwszDatabaseName en el mismo nombre. El nombre de la base de datos de copia de seguridad se construye a partir de la ruta de acceso devuelta por la llamada del cliente de copia de seguridad a la función CertSrvRestoreGetDatabaseLocations . Se habría llamado a CertSrvRestoreGetDatabaseLocations durante una copia de seguridad completa y el cliente de copia de seguridad habría guardado la ruta de acceso devuelta.

Si va a realizar una restauración incremental, establezca este parámetro en NULL.

[in] crstmap

Número de elementos de la matriz rgrstmap . Establezca este valor en uno si va a realizar una restauración completa o cero si va a realizar una restauración incremental.

[in, optional] pwszBackupLogPath

Puntero a una cadena Unicode terminada en null que contiene la ruta de acceso del directorio de registro de copia de seguridad. Pase NULL para este parámetro si no es necesario.

[in] genLow

Número de registro más bajo que se restauró en esta sesión de restauración. Los archivos de registro están en forma de edbXXXXX.log, donde XXXXX es un valor de cinco dígitos hexadecimales. Por ejemplo, edb00001.log es el primer archivo de registro creado por la base de datos interna. Para los fines de esta función, un valor de uno de genLow corresponde al archivo de registro edb00001.log.

[in] genHigh

Número de registro más alto que se restauró en esta sesión de restauración.

Valor devuelto

El valor devuelto es un HRESULT. Un valor de S_OK indica que se ha realizado correctamente.

Comentarios

Esta función es idéntica a la función CertSrvRestoreRegister , salvo que CertSrvRestoreRegister requiere que la cuenta de llamada sea un administrador local. La función CertSrvRestoreRegisterThroughFile solo requiere que la cuenta de llamada tenga el privilegio de restauración.

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	certbcli.h (incluya Certsrv.h)
Library	Certadm.lib
Archivo DLL	Certadm.dll

Consulte también

CertSrvRestoreRegister

CertSrvRestoreRegisterComplete

Uso de las funciones de copia de seguridad y restauración de Servicios de certificados