Función CertSrvIsServerOnlineW (certbcli.h)

La función CertSrvIsServerOnline determina si un servidor de Servicios de certificados está en línea; Si el servidor de Servicios de certificados no está en línea, las operaciones de copia de seguridad no se realizarán correctamente.

Sintaxis

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

Parámetros

[in] pwszServerName

Puntero al nombre del equipo NetBIOS o DNS del servidor para comprobar el estado en línea.

[out] pfServerOnline

Puntero al valor booleano que será TRUE si el servidor de Servicios de certificados está en línea y FALSE si no está en línea.

Valor devuelto

El valor devuelto es hrESULT. Esta función producirá un error si servicios de certificados no se está ejecutando. Si Servicios de certificados se está ejecutando y listo para aceptar solicitudes, esta función devolverá S_OK y *pfServerOnline apuntará a un valor true. Si Servicios de certificados se ejecuta en modo suspendido (o en pausa), esta función devolverá S_OK y *pfServerOnline apuntará a un valor false.

Comentarios

Llame a esta función para determinar si un servidor de Servicios de certificados está en línea y está disponible para las operaciones de copia de seguridad.

El nombre de esta función en Certadm.dll es CertSrvIsServerOnlineW. Debe usar este formato del nombre al llamar a GetProcAddress. Además, esta función se define como tipo FNCERTSRVISSERVERONLINEW en el archivo de encabezado Certbcli.h.

Ejemplos

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	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	certbcli.h (incluya Certsrv.h)
Library	Certadm.lib
Archivo DLL	Certadm.dll

Consulte también

CertSrvBackupPrepare

Uso de las funciones de copia de seguridad y restauración de Servicios de certificados