CertSrvIsServerOnlineW-Funktion (certbcli.h)

Artikel
02/23/2024

Die CertSrvIsServerOnline-Funktion bestimmt, ob ein Certificate Services-Server online ist. Wenn der Zertifikatdiensteserver nicht online ist, sind Sicherungsvorgänge nicht erfolgreich.

Syntax

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

Parameter

[in] pwszServerName

Ein Zeiger auf den NetBIOS- oder DNS-Computernamen des Servers, um nach Online-status zu suchen.

[out] pfServerOnline

Ein Zeiger auf den booleschen Wert, der TRUE ist, wenn der Zertifikatdiensteserver online ist, und FALSE , wenn er nicht online ist.

Rückgabewert

Der Rückgabewert ist ein HRESULT. Diese Funktion schlägt fehl, wenn Die Zertifikatdienste nicht ausgeführt werden. Wenn Zertifikatdienste ausgeführt werden und bereit sind, Anforderungen zu akzeptieren, gibt diese Funktion S_OK zurück, und *pfServerOnline zeigt auf den Wert TRUE. Wenn Zertifikatdienste im angehaltenen (oder angehaltenen) Modus ausgeführt werden, gibt diese Funktion S_OK zurück, und *pfServerOnline zeigt auf den Wert FALSE.

Hinweise

Rufen Sie diese Funktion auf, um zu ermitteln, ob ein Certificate Services-Server online ist und für Sicherungsvorgänge verfügbar ist.

Der Name dieser Funktion in Certadm.dll lautet CertSrvIsServerOnlineW. Sie müssen diese Form des Namens verwenden, wenn Sie GetProcAddress aufrufen. Außerdem wird diese Funktion als Typ FNCERTSRVISSERVERONLINEW in der Headerdatei Certbcli.h definiert.

Beispiele

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certbcli.h (include Certsrv.h)
Bibliothek	Certadm.lib
DLL	Certadm.dll

Weitere Informationen

CertSrvBackupPrepare

Verwenden der Sicherungs- und Wiederherstellungsfunktionen für Zertifikatdienste

Freigeben über