CertSrvIsServerOnlineW, fonction (certbcli.h)

  • Article

La fonction CertSrvIsServerOnline détermine si un serveur des services de certificats est en ligne ; si le serveur des services de certificats n’est pas en ligne, les opérations de sauvegarde ne réussissent pas.

Syntaxe

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

Paramètres

[in] pwszServerName

Pointeur vers le nom de machine NetBIOS ou DNS du serveur à case activée pour les status en ligne.

[out] pfServerOnline

Pointeur vers la valeur booléenne qui sera TRUE si le serveur des services de certificats est en ligne et FALSE s’il n’est pas en ligne.

Valeur retournée

La valeur de retour est un HRESULT. Cette fonction échoue si les services de certificats ne sont pas en cours d’exécution. Si les services de certificats sont en cours d’exécution et prêts à accepter des demandes, cette fonction retourne S_OK et *pfServerOnline pointe vers une valeur TRUE. Si les services de certificats s’exécutent en mode suspendu (ou suspendu), cette fonction retourne S_OK et *pfServerOnline pointe vers la valeur FALSE.

Remarques

Appelez cette fonction pour déterminer si un serveur des services de certificats est en ligne et disponible pour les opérations de sauvegarde.

Le nom de cette fonction dans Certadm.dll est CertSrvIsServerOnlineW. Vous devez utiliser cette forme de nom lors de l’appel de GetProcAddress. En outre, cette fonction est définie comme type FNCERTSRVISSERVERONLINEW dans le fichier d’en-tête Certbcli.h.

Exemples

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

Configuration requise

Condition requise Valeur
Client minimal pris en charge Aucun pris en charge
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête certbcli.h (include Certsrv.h)
Bibliothèque Certadm.lib
DLL Certadm.dll

Voir aussi

CertSrvBackupPrepare

Utilisation des fonctions de sauvegarde et de restauration des services de certificat