Funzione CertSrvServerControlW (certbcli.h)

  • Articolo

La funzione CertSrvServerControl genera un comando di controllo del servizio per arrestare a livello di codice Servizi certificati.

Sintassi

HRESULT CERTBCLI_API CertSrvServerControlW(
  [in]  WCHAR const *pwszServerName,
  [in]  DWORD       dwControlFlags,
  [out] DWORD       *pcbOut,
  [out] BYTE        **ppbOut
);

Parametri

[in] pwszServerName

Puntatore a un nome o a una stringa di configurazione del server da emettere il comando di controllo.

[in] dwControlFlags

Valore che rappresenta il comando di controllo rilasciato al server Servizi certificati specificato da pwszServerName. Il valore seguente è supportato per dwControlFlags.

Valore Significato
CSCONTROL_SHUTDOWN
 Arrestare i servizi certificati.

[out] pcbOut

Per l'uso futuro, questo parametro sarà il numero di byte allocati a ppbOut. L'implementazione corrente non alloca memoria a ppbOut. È possibile impostare questo valore su NULL.

[out] ppbOut

Per l'uso futuro, questo parametro sarà il puntatore a byte che rappresenta l'output del comando rilasciato. L'implementazione corrente non alloca memoria a ppbOut. È possibile impostare questo valore su NULL.

Valore restituito

Il valore restituito è un HRESULT. Un valore di S_OK indica l'esito positivo.

Commenti

Lo scopo di questa funzione consiste nell'consentire a un'applicazione di backup o ripristino di arrestare a livello di codice l'applicazione Servizi certificati (pertanto non richiede l'uso delle API del controller di servizio). L'arresto dei servizi certificati in questo modo funzionerà anche quando i servizi certificati vengono eseguiti in modalità console; le API del controller di servizio non possono controllare le applicazioni in esecuzione in modalità console.

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

Esempio

FNCERTSRVSERVERCONTROLW* pfnControl;
char * szControlFunc = "CertSrvServerControlW";
HRESULT    hr=0;

// Get the address for the desired function.
// hInst was set by calling LoadLibrary for Certadm.dll.
pfnControl = (FNCERTSRVSERVERCONTROLW*)GetProcAddress(hInst,
                                           szControlFunc);
if ( NULL == pfnControl )
{
    printf("Failed GetProcAddress - %s, error=%d\n",
           szControlFunc,
           GetLastError() );
    exit(1); // Or other appropriate error action.
}

// Issue a command to stop the service.
hr = pfnControl( L"MyCertServMachine",
                 CSCONTROL_SHUTDOWN,
                 NULL,
                 NULL);

if ( FAILED( hr ) )
{
    printf("Failed pfnControl call [%x]\n", hr);
    exit(1); // Or other appropriate error action.
}

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