Функция CertSrvRestoreRegisterThroughFile (certbcli.h)

Статья
08/22/2023

Функция 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 .

[in, optional] pwszLogPath

Указатель на строку Юникода, завершающуюся null, которая содержит текущий каталог файла журнала. Если этот параметр не требуется, передайте значение NULL .

[in, optional] rgrstmap

Массив структур CSEDB_RSTMAP , содержащий карту восстановления. Если выполняется полное восстановление базы данных, этот параметр указывает имя резервной базы данных, а также новое имя базы данных после ее восстановления. На имя резервной базы данных ссылается член pwszDatabaseName , а на новое имя базы данных — элемент pwszNewDatabaseName . Если цель состоит в том, чтобы сохранить одинаковое имя как для резервной, так и для восстановленной базы данных, задайте для членов pwszNewDatabaseName и pwszDatabaseName одинаковое имя. Имя резервной базы данных создается на основе пути, возвращаемого вызовом клиента резервного копирования функции CertSrvRestoreGetDatabaseLocations . CertSrvRestoreGetDatabaseLocations был бы вызван во время полного резервного копирования, а клиент резервного копирования сохранил бы возвращенный путь.

Если выполняется добавочное восстановление, задайте для этого параметра значение NULL.

[in] crstmap

Количество элементов в массиве rgrstmap . Задайте для этого значения значение 1, если выполняется полное восстановление, или ноль, если выполняется добавочное восстановление.

[in, optional] pwszBackupLogPath

Указатель на строку Юникода, завершающуюся null, которая содержит путь к каталогу журнала резервного копирования. Если этот параметр не требуется, передайте значение NULL .

[in] genLow

Наименьший номер журнала, восстановленный в этом сеансе восстановления. Файлы журналов имеют форму edbXXXXX.log, где XXXXX — это значение пяти шестнадцатеричных цифр. Например, edb00001.log является первым файлом журнала, созданным внутренней базой данных. Для целей этой функции значение 1 в genLow соответствует edb00001.log файла журнала.

[in] genHigh

Самый высокий номер журнала, который был восстановлен в этом сеансе восстановления.

Возвращаемое значение

Возвращаемое значение — HRESULT. Значение S_OK указывает на успешное выполнение.

Эта функция идентична функции CertSrvRestoreRegister , за исключением того, что CertSrvRestoreRegister требует, чтобы вызывающая учетная запись была локальным администратором. Функция CertSrvRestoreRegisterThroughFile требует, чтобы у вызывающей учетной записи были права на восстановление.

Требования

Требование	Значение
Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	certbcli.h (включая Certsrv.h)
Библиотека	Certadm.lib
DLL	Certadm.dll

См. также раздел

CertSrvRestoreRegister

CertSrvRestoreRegisterComplete

Использование функций резервного копирования и восстановления служб сертификатов