Fungsi CertSrvServerControlW (certbcli.h)

  • Artikel

Fungsi CertSrvServerControl mengeluarkan perintah kontrol layanan untuk menghentikan Layanan Sertifikat secara terprogram.

Sintaks

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

Parameter

[in] pwszServerName

Penunjuk ke nama atau string konfigurasi server yang akan dikeluarkan perintah kontrol.

[in] dwControlFlags

Nilai yang mewakili perintah kontrol yang dikeluarkan ke server Layanan Sertifikat yang ditentukan oleh pwszServerName. Nilai berikut didukung untuk dwControlFlags.

Nilai Makna
CSCONTROL_SHUTDOWN
 Hentikan Layanan Sertifikat.

[out] pcbOut

Untuk penggunaan di masa mendatang, parameter ini akan menjadi jumlah byte yang dialokasikan untuk ppbOut. Implementasi saat ini tidak mengalokasikan memori ke ppbOut. Anda dapat mengatur nilai ini ke NULL.

[out] ppbOut

Untuk penggunaan di masa mendatang, parameter ini akan menjadi penunjuk ke byte yang mewakili output dari perintah yang dikeluarkan. Implementasi saat ini tidak mengalokasikan memori ke ppbOut. Anda dapat mengatur nilai ini ke NULL.

Nilai kembali

Nilai yang dikembalikan adalah HRESULT. Nilai S_OK menunjukkan keberhasilan.

Keterangan

Tujuan dari fungsi ini adalah untuk memungkinkan aplikasi pencadangan atau pemulihan secara terprogram menghentikan aplikasi Layanan Sertifikat (sehingga tidak memerlukan penggunaan API pengontrol layanan). Menghentikan Layanan Sertifikat dengan cara ini juga akan berfungsi ketika Layanan Sertifikat berjalan dalam mode konsol; API pengontrol layanan tidak dapat mengontrol aplikasi yang berjalan dalam mode konsol.

Nama fungsi ini dalam Certadm.dll adalah CertSrvServerControlW. Anda harus menggunakan bentuk nama ini saat memanggil GetProcAddress. Selain itu, fungsi ini didefinisikan sebagai jenis FNCERTSRVSERVERCONTROLW dalam file header Certbcli.h.

Contoh

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.
}

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tidak ada yang didukung
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header certbcli.h (termasuk Certsrv.h)
Pustaka Certadm.lib
DLL Certadm.dll

Lihat juga

Menggunakan Fungsi Pencadangan dan Pemulihan Layanan Sertifikat