Функция 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 .
[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 |
См. также раздел
CertSrvRestoreRegisterComplete
Использование функций резервного копирования и восстановления служб сертификатов
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по