CertSrvRestoreRegisterThroughFile 函数 (certbcli.h)
CertSrvRestoreRegisterThroughFile 函数注册证书服务还原。
语法
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
);
参数
[in] hbc
证书服务还原上下文的句柄。 此句柄是通过调用 CertSrvRestorePrepare 函数获取的。
[in, optional] pwszCheckPointFilePath
指向以 null 结尾的 Unicode 字符串的指针，该字符串包含检查点文件的还原路径。 如果不需要此参数，请为此参数传递 NULL 。
[in, optional] pwszLogPath
指向包含当前日志文件目录的以 null 结尾的 Unicode 字符串的指针。 如果不需要此参数，请为此参数传递 NULL 。
[in, optional] rgrstmap
包含还原映射 的CSEDB_RSTMAP 结构的数组。 如果要执行完整数据库还原，此参数将指定备份数据库的名称，以及还原后该数据库的新名称。 备份数据库名称由 pwszDatabaseName 成员引用，新数据库名称由 pwszNewDatabaseName 成员引用。 如果目的是为备份数据库和还原的数据库保留相同的名称，请将 pwszNewDatabaseName 和 pwszDatabaseName 成员设置为同一名称。 备份数据库名称是从备份客户端调用 CertSrvRestoreGetDatabaseLocations 函数返回的路径构造的。 在完整备份期间会调用 CertSrvRestoreGetDatabaseLocations，备份客户端将保存返回的路径。
如果要执行增量还原，请将此参数设置为 NULL。
[in] crstmap
rgrstmap 数组中的元素数。 如果 正在执行完全还原，请将此值设置为 1;如果要执行增量还原，则将此值设置为 0。
[in, optional] pwszBackupLogPath
指向包含备份日志目录路径的以 null 结尾的 Unicode 字符串的指针。 如果不需要此参数，请为此参数传递 NULL 。
[in] genLow
在此还原会话中还原的最小日志编号。 日志文件采用edbXXXXX.log形式，其中 XXXXX 是五个十六进制数字值。 例如，edb00001.log 是内部数据库创建的第一个日志文件。 对于此函数， genLow 中的值 1 对应于日志文件edb00001.log。
[in] genHigh
在此还原会话中还原的最高日志编号。
返回值
返回值为 HRESULT。 值为 S_OK 表示成功。
注解
此函数与 CertSrvRestoreRegister 函数相同，只是 CertSrvRestoreRegister 要求调用帐户是本地管理员。 CertSrvRestoreRegisterThroughFile 函数仅要求调用帐户具有还原特权。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 无受支持的版本 |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | certbcli.h (包括 Certsrv.h) |
| Library | Certadm.lib |
| DLL | Certadm.dll |