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

  • Статья

Функция CertSrvRestoreRegisterComplete завершает операцию восстановления зарегистрированных служб сертификатов.

Синтаксис

HRESULT CERTBCLI_API CertSrvRestoreRegisterComplete(
  [in] HCSBC   hbc,
  [in] HRESULT hrRestoreState
);

Параметры

[in] hbc

Дескриптор для контекста восстановления служб сертификатов. Этот дескриптор необходимо задать, вызвав CertSrvRestoreRegister перед его использованием в CertSrvRestoreRegisterComplete.

[in] hrRestoreState

Значение HRESULT, указывающее код успешного выполнения операции восстановления. Задайте для этого значения значение S_OK, если операция восстановления прошла успешно.

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

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

Комментарии

Если зарегистрированная операция восстановления не завершена, службы сертификатов не запускаются.

Примеры

FNCERTSRVRESTOREREGISTERCOMPLETE* pfnRestRegComplete;
char * szResRegCompleteFunc = "CertSrvRestoreRegisterComplete";
HRESULT    hr=0;

// Get the address for the desired function.
// hInst was set by calling LoadLibrary for Certadm.dll.
pfnRestRegComplete = (FNCERTSRVRESTOREREGISTERCOMPLETE*)
                     GetProcAddress( hInst, szResRegCompleteFunc );
if ( NULL == pfnRestRegComplete )
{
    printf("Failed GetProcAddress - %s, error=%d\n",
           szResRegCompleteFunc,
           GetLastError() );
    exit(1); // Or other appropriate error action.
}

// Complete a registered restoration operation.
// hCSBC is an HCSBC variable used in a previous
// call to CertSrvRestoreRegister.
hr = pfnRestRegComplete(hCSBC, S_OK);
if (FAILED(hr))
{
    printf("Failed pfnRestRegComplete call [%x]\n", hr);
    exit(1); // Or other appropriate error action.
}

Требования

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

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

CertSrvRestoreRegister

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