Funzione CertSrvIsServerOnlineW (certbcli.h)

  • Articolo

La funzione CertSrvIsServerOnline determina se un server di Servizi certificati è online; se il server Servizi certificati non è online, le operazioni di backup non avranno esito positivo.

Sintassi

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

Parametri

[in] pwszServerName

Puntatore al nome del computer NetBIOS o DNS del server per verificare lo stato online.

[out] pfServerOnline

Puntatore al valore booleano che sarà TRUE se il server Servizi certificati è online e FALSE se non è online.

Valore restituito

Il valore restituito è un HRESULT. Questa funzione avrà esito negativo se Servizi certificati non è in esecuzione. Se Servizi certificati è in esecuzione e pronto per accettare le richieste, questa funzione restituirà S_OK e *pfServerOnline punta a un valore true. Se Servizi certificati è in esecuzione in modalità sospesa (o sospesa), questa funzione restituirà S_OK e *pfServerOnline punta a un valore false.

Commenti

Chiamare questa funzione per determinare se un server di Servizi certificati è online e disponibile per le operazioni di backup.

Il nome di questa funzione in Certadm.dll è CertSrvIsServerOnlineW. È necessario usare questo formato del nome quando si chiama GetProcAddress. Questa funzione viene inoltre definita come tipo FNCERTSRVISSERVERONLINEW nel file di intestazione Certbcli.h.

Esempio

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

Requisiti

Requisito Valore
Client minimo supportato Nessuno supportato
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione certbcli.h (includere Certsrv.h)
Libreria Certadm.lib
DLL Certadm.dll

Vedi anche

CertSrvBackupPrepare

Uso delle funzioni di backup e ripristino dei servizi certificati