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
CertSrvRestoreRegisterComplete
Uso de las funciones de copia de seguridad y restauración de Servicios de certificados