Fungsi CertSrvServerControlW (certbcli.h)
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 |
---|---|
|
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