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

Статья
08/22/2023

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

Синтаксис

HRESULT CERTBCLI_API CertSrvIsServerOnlineW(
  [in]  WCHAR const *pwszServerName,
  [out] BOOL        *pfServerOnline
);

Параметры

[in] pwszServerName

Указатель на имя компьютера NetBIOS или DNS сервера, для проверка состояние в сети.

[out] pfServerOnline

Указатель на логическое значение, которое будет иметь значение TRUE , если сервер служб сертификатов подключен к сети, и FALSE , если он не подключен.

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

Возвращаемое значение — HRESULT. Эта функция завершится сбоем, если службы сертификатов не запущены. Если службы сертификатов запущены и готовы принимать запросы, эта функция вернет S_OK, а *pfServerOnline будет указывать на значение TRUE. Если службы сертификатов работают в приостановленном (или приостановленном) режиме, эта функция вернет S_OK, а *pfServerOnline будет указывать на значение FALSE.

Имя этой функции в Certadm.dll — CertSrvIsServerOnlineW. Эту форму имени необходимо использовать при вызове GetProcAddress. Кроме того, эта функция определена как тип FNCERTSRVISSERVERONLINEW в файле заголовка Certbcli.h.

Примеры

FNCERTSRVISSERVERONLINEW* pfnOnline = NULL;
char * szOnlineFunc = "CertSrvIsServerOnlineW";
BOOL       bOnline = 0;
HRESULT    hr = 0;

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

// Call the function; wszServer was set earlier to the server name.
hr = pfnOnline(wszServer, &bOnline);
if (FAILED(hr))
{
    printf("Failed pfnOnline, hr=%x, err=%d\n",
           hr,
           GetLastError());
    exit(1);  // Or other appropriate error action.
}

// Display the online status.
printf("Server is %s\n", 
       (bOnline ? "Online" : "Suspended" ));

Требования

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

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

CertSrvBackupPrepare

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

Поделиться через