Compartilhar via


Função CertSrvIsServerOnlineW (certbcli.h)

A função CertSrvIsServerOnline determina se um servidor dos Serviços de Certificados está online; se o servidor dos Serviços de Certificados não estiver online, as operações de backup não serão bem-sucedidas.

Sintaxe

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

Parâmetros

[in] pwszServerName

Um ponteiro para o nome do computador NetBIOS ou DNS do servidor para marcar para status online.

[out] pfServerOnline

Um ponteiro para o valor booliano que será TRUE se o servidor dos Serviços de Certificados estiver online e FALSE se ele não estiver online.

Retornar valor

O valor retornado é um HRESULT. Essa função falhará se os Serviços de Certificados não estiverem em execução. Se os Serviços de Certificados estiverem em execução e estiverem prontos para aceitar solicitações, essa função retornará S_OK e *pfServerOnline apontará para um valor TRUE. Se os Serviços de Certificados estiverem em execução no modo suspenso (ou pausado), essa função retornará S_OK e *pfServerOnline apontará para um valor false.

Comentários

Chame essa função para determinar se um servidor dos Serviços de Certificados está online e disponível para operações de backup.

O nome dessa função no Certadm.dll é CertSrvIsServerOnlineW. Você deve usar essa forma do nome ao chamar GetProcAddress. Além disso, essa função é definida como o tipo FNCERTSRVISSERVERONLINEW no arquivo de cabeçalho Certbcli.h.

Exemplos

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" ));

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho certbcli.h (inclua Certsrv.h)
Biblioteca Certadm.lib
DLL Certadm.dll

Confira também

CertSrvBackupPrepare

Usando as funções de backup e restauração dos Serviços de Certificados