PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE fungsi panggilan balik (wincrypt.h)

Artikel
03/03/2024

Fungsi PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE menginisialisasi penyedia. Anda harus menerapkan fungsi ini sebagai bagian dari penyedia kustom Anda.

Sintaks

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE PfnCryptObjectLocatorProviderInitialize;

BOOL PfnCryptObjectLocatorProviderInitialize(
  [in]  PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FLUSH pfnFlush,
  [in]  LPVOID pContext,
  [out] DWORD *pdwExpectedObjectCount,
  [out] PCRYPT_OBJECT_LOCATOR_PROVIDER_TABLE *ppFuncTable,
  [out] void **ppPluginContext
)
{...}

Parameter

[in] pfnFlush

Arahkan ke implementasi fungsi PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FLUSH .

[in] pContext

Penunjuk ke objek yang ditentukan penyedia yang berisi informasi tentang penyedia dan objek.

[out] pdwExpectedObjectCount

Menentukan jumlah objek unik yang diharapkan penyedia untuk menemukannya. Nilai ini memberi tahu pemanggil berapa banyak memori yang akan dialokasikan untuk menyimpan objek. Atur nilai ini ke nol (0) untuk menentukan nilai default 10.000 objek.

[out] ppFuncTable

Struktur CRYPT_OBJECT_LOCATOR_PROVIDER_TABLE yang berisi pointer ke fungsi yang diterapkan oleh penyedia. Tidak ada penunjuk dalam tabel yang bisa NULL. Pemanggil tidak membebaskan struktur ini. Diharapkan penyedia akan mengembalikan tabel yang tidak dialokasikan pada heap.

[out] ppPluginContext

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

Nilai kembali

Jika fungsi berhasil, kembalikan bukan nol (TRUE).

Jika fungsi gagal, kembalikan nol (FALSE) dan tentukan kesalahan yang sesuai dalam fungsi SetLastError . Sebagian besar kesalahan diteruskan melalui Schannel yang tidak diubah tetapi perilaku ini tidak dijamin. Beberapa kesalahan mungkin dipetakan ke kesalahan lain.

Keterangan

Fungsi PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE saat ini hanya dipanggil oleh penyedia layanan keamanan (SSP) Saluran Aman (Schannel). API Kriptografi (CAPI) akan secara internal memanggil penyedia kustom Anda jika, dimulai dengan Windows 8, Anda menentukan nama prinsip keamanan dalam parameter pszPrincipal dari fungsi AcquireCredentialsHandle.

Saat Anda menerapkan fungsi ini, ingatlah untuk mengisi tabel fungsi CRYPT_OBJECT_LOCATOR_PROVIDER_TABLE dengan pointer ke fungsi berikut yang diterapkan oleh penyedia Anda:

Anda harus memanggil CryptRegisterDefaultOIDFunction untuk mendaftarkan penyedia di registri Windows.

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_FLUSH

Bagikan melalui