Funzione CertSrvIsServerOnlineW (certbcli.h)
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
Uso delle funzioni di backup e ripristino dei servizi certificati