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

另请参阅

CertSrvRestoreRegister

CertSrvRestoreRegisterComplete

使用证书服务备份和还原函数