PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE fungsi panggilan balik (wincrypt.h)

Artikel
08/27/2023

Fungsi panggilan balik PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE merilis penyedia.

Sintaks

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE PfnCryptObjectLocatorProviderRelease;

void PfnCryptObjectLocatorProviderRelease(
  [in]           DWORD dwReason,
  [in, optional] LPVOID pPluginContext
)
{...}

Parameter

[in] dwReason

Menentukan alasan penyedia dirilis. Ini bisa menjadi salah satu nilai berikut:

Nilai	Makna
CRYPT_OBJECT_LOCATOR_RELEASE_SYSTEM_SHUTDOWN 1	Komputer sedang dimatikan.
CRYPT_OBJECT_LOCATOR_RELEASE_SERVICE_STOP 2	Layanan berhenti.
CRYPT_OBJECT_LOCATOR_RELEASE_PROCESS_EXIT 3	Proses panggilan berakhir.
CRYPT_OBJECT_LOCATOR_RELEASE_DLL_UNLOAD 4	DLL penyedia sedang dibongkar.

[in, optional] pPluginContext

Penunjuk ke buffer opsional yang ditentukan oleh penyedia ini dan dikembalikan oleh fungsi PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE . Buffer tidak dimodifikasi oleh pemanggil. Penyedia Anda dapat menggunakan data untuk membantunya menentukan tindakan apa yang harus dilakukan atau untuk mempertahankan informasi tambahan.

Nilai kembali

Tidak ada

Keterangan

Fungsi panggilan balik PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_RELEASE saat ini hanya dipanggil oleh paket keamanan Saluran Aman (Schannel). Fungsi ini dipanggil sekali untuk setiap panggilan yang dilakukan ke PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE.

Penyedia tidak diharapkan untuk merilis semua memori untuk semua objek tetapi harus membersihkan dirinya sendiri jika parameter dwReason diatur ke CRYPT_OBJECT_LOCATOR_RELEASE_SERVICE_STOP atau CRYPT_OBJECT_LOCATOR_RELEASE_DLL_UNLOAD.

Fungsi ini harus diblokir sehingga panggilan ke PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FLUSH dapat selesai.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	wincrypt.h

Lihat juga

CRYPT_OBJECT_LOCATOR_PROVIDER_TABLE

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE

Bagikan melalui