Antarmuka ICertExit (certexit.h)

Artikel
03/14/2023

Antarmuka ICertExit menyediakan komunikasi antara server Layanan Sertifikat dan modul keluar.

Catatan Modul keluar dapat berkomunikasi dengan server Layanan Sertifikat dengan menggunakan antarmuka ICertServerExit .

Server Layanan Sertifikat memanggil metode ICertExit untuk melakukan tugas berikut:

Menginisialisasi server Layanan Sertifikat.
Beri tahu modul keluar peristiwa seperti penerbitan sertifikat, penerbitan daftar pencabutan sertifikat (CRL), atau pematian server, telah terjadi.
Ambil deskripsi modul keluar.

ICertExit didefinisikan dalam Certexit.h. Namun, saat Anda membuat program, gunakan Certsrv.h sebagai file sertakan.

Antarmuka Layanan Sertifikat mendukung model rangkaian apartemen dan utas bebas. Untuk throughput yang lebih baik, disarankan untuk threading gratis.

Warisan

Antarmuka ICertExit mewarisi dari antarmuka IDispatch . ICertExit juga memiliki jenis anggota ini:

Metode

Antarmuka ICertExit memiliki metode ini.


ICertExit::GetDescription Mengembalikan deskripsi modul keluar yang dapat dibaca manusia dan fungsinya.
ICertExit::Initialize Dipanggil oleh mesin server ketika menginisialisasi dirinya sendiri.
ICertExit::Beri tahu Dipanggil oleh mesin server untuk memberi tahu modul keluar bahwa suatu peristiwa telah terjadi.

Keterangan

Implementer ICertExit juga harus menerapkan ICertManageModule. Selain itu, ProgID untuk kelas yang menerapkan ICertExit harus sesuai dengan konvensi penamaan. Secara khusus, ProgID harus dalam bentuk:

"MyApp. Keluar"

Di mana MyApp adalah penentu yang mengidentifikasi aplikasi. Misalnya, di C++, kode berikut dapat digunakan dalam makro DECLARE_REGISTRY kelas (CMyCertExitModule) yang mengimplementasikan ICertExit.

DECLARE_REGISTRY(
    CMyCertExitModule,
    L"MyCode.Exit.1",
    L"MyCode.Exit",
    IDS_CERTEXITMODULE_DESC,
    THREADFLAGS_BOTH)

Untuk sampel sebelumnya, nilai IDS_CERTEXITMODULE_DESC adalah pengidentifikasi khusus aplikasi dalam file sumber daya (.rc) untuk string yang menjelaskan kelas .

Konstanta string yang ditentukan dalam Certmod.h dapat digunakan untuk menyederhanakan mengikuti konvensi penamaan.

Terus-menerus	Nilai
wszCERTEXITMODULE_POSTFIX	TEXT(". Keluar")

Tidak lebih dari satu modul keluar Visual Basic Scripting Edition yang dapat didaftarkan di server Layanan Sertifikat pada satu waktu. Jika lebih dari satu modul keluar Visual Basic Scripting Edition terdaftar, snap-in MMC Otoritas Sertifikasi, aplikasi Layanan Sertifikat, atau program baris perintah sertutil dapat menghasilkan kesalahan. Perhatikan bahwa lingkungan pengembangan Visual Basic Scripting Edition secara otomatis mendaftarkan DLL saat berhasil dibuat. Akibatnya, Anda mungkin mengalami situasi ini ketika satu modul keluar Visual Basic Scripting Edition sudah terdaftar dan modul keluar Visual Basic Scripting Edition lainnya dibuat. Untuk menghindari situasi ini, Anda harus membatalkan pendaftaran salah satu modul keluar Visual Basic Scripting Edition, melalui instruksi baris perintah regsvr32 /u FileName.dll, di mana FileName.dll adalah nama modul keluar Visual Basic Scripting Edition yang tidak dimaksudkan untuk dibuat aktif.

Pelaksana ICertExit di Visual Basic Scripting Edition harus memberi nama proyek mereka dalam bentuk:

"MyApp"

Di mana MyApp adalah penentu yang mengidentifikasi aplikasi; selanjutnya, kelas yang mengimplementasikan ICertExit harus diberi nama "Exit".

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	certexit.h (termasuk Certsrv.h)

Lihat juga

ICertServerExit

IDispatch

Bagikan melalui