ICertExit::Inisialisasi metode (certexit.h)

Artikel
03/14/2023

Metode Inisialisasi dipanggil oleh mesin server ketika menginisialisasi dirinya sendiri.

Panggilan ke metode Inisialisasi modul keluar memungkinkan modul keluar untuk melakukan inisialisasi dan memberi tahu mesin server jenis peristiwa mana yang ingin diberi tahu.

Sintaks

HRESULT Initialize(
  [in]          const BSTR strConfig,
  [out, retval] LONG       *pEventMask
);

Parameter

[in] strConfig

Mewakili nama otoritas sertifikasi, seperti yang dimasukkan selama penyiapan Layanan Sertifikat. Untuk informasi tentang nama string konfigurasi, lihat ICertConfig2.

[out, retval] pEventMask

Penunjuk ke nilai yang mewakili peristiwa di mana modul keluar meminta pemberitahuan. Ini bisa menjadi satu atau beberapa nilai berikut.

Nilai	Makna
EXITEVENT_CERTDENIED	Sertifikat ditolak.
EXITEVENT_CERTISSUED	Sertifikat dikeluarkan.
EXITEVENT_CERTPENDING	Sertifikat tertunda.
EXITEVENT_CERTRETRIEVEPENDING	Panggilan berhasil ke RetrievePending.
EXITEVENT_CERTREVOKED	Sertifikat dicabut.
EXITEVENT_CRLISSUED	Daftar pencabutan sertifikat dikeluarkan.
EXITEVENT_SHUTDOWN	Penonaktifan Layanan Sertifikat.

Nilai kembali

C++

Jika metode berhasil, metode mengembalikan S_OK dan *pEventMask diatur ke kombinasi bendera dalam tabel di bawah ini (atau EXITEVENT_INVALID jika modul keluar tidak ingin diberi tahu tentang peristiwa apa pun).

Jika metode gagal, metode mengembalikan nilai HRESULT yang menunjukkan kesalahan. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.

Jika modul keluar tidak ingin diberi tahu tentang peristiwa apa pun, maka bendera EXITEVENT_INVALID harus diatur.

VB

Nilai yang dikembalikan adalah masker yang berisi bendera yang menunjukkan peristiwa di mana modul keluar meminta pemberitahuan. Setelah panggilan, semua peristiwa dari jenis tersebut akan disinyalir oleh mesin server ke modul keluar melalui panggilan ke Beri Tahu. Salah satu atau semua bendera berikut dapat diatur.

Mengembalikan kode/nilai	Deskripsi
EXITEVENT_CERTDENIED &H4	Sertifikat ditolak.
EXITEVENT_CERTISSUED &H1	Sertifikat dikeluarkan.
EXITEVENT_CERTPENDING &H2	Sertifikat tertunda.
EXITEVENT_CERTRETRIEVEPENDING &H10	Panggilan berhasil ke RetrievePending.
EXITEVENT_CERTREVOKED &H8	Sertifikat dicabut.
EXITEVENT_CRLISSUED &H20	Daftar pencabutan sertifikat dikeluarkan.
EXITEVENT_INVALID 0	Kejadian saat ini tidak valid.
EXITEVENT_SHUTDOWN &H40	Penonaktifan Layanan Sertifikat.

Keterangan

Saat Anda menulis modul keluar kustom, terapkan metode ini.

Contoh

#include <windows.h>
#include <stdio.h>
#include <Certexit.h>

STDMETHODIMP CCertExit::Initialize(
    /* [in] */ BSTR const strConfig,
    /* [retval][out] */ LONG __RPC_FAR *pEventMask)
{
    // Verify valid pointer passed in.
    if (NULL == pEventMask)
        return ( E_POINTER );  // Bad pointer

    // strConfig can be used by the Exit module.
    // Here, it is stored in a BSTR member variable.
    // Remember to call SysFreeString to free m_strConfig when done.
    m_strConfig = SysAllocString( strConfig );
    // Check to determine whether there was enough memory.
    if (NULL == m_strConfig)
        return ( E_OUTOFMEMORY );  // Not enough memory

    // Inform server engine (CA) that we're interested in
    // the following events.
    *pEventMask = EXITEVENT_CERTISSUED |
                  EXITEVENT_CERTPENDING |
                  EXITEVENT_CERTDENIED |
                  EXITEVENT_CERTREVOKED |
                  EXITEVENT_CERTRETRIEVEPENDING |
                  EXITEVENT_CRLISSUED |
                  EXITEVENT_SHUTDOWN;

    if ( fDebug )
    {
        printf("Exit's Initialize member called\n");
        printf("\tstrConfig = %ws\n", strConfig );
    }

    return( S_OK );
}

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

ICertExit

ICertExit2

Beri tahu

Share via