Fungsi GetCryptProvFromCert

Artikel
06/13/2023

Penting

API ini tidak digunakan lagi. Microsoft dapat menghapus API ini dalam rilis mendatang.

Fungsi GetCryptProvFromCert mendapatkan handel ke penyedia layanan kriptografi (CSP) dan spesifikasi kunci untuk konteks sertifikat . Gunakan fungsi ini untuk mendapatkan akses ke kunci privat penerbit sertifikat.

Catatan

Fungsi ini tidak memiliki file header atau pustaka impor terkait. Untuk memanggil fungsi ini, Anda harus membuat file header yang ditentukan pengguna dan menggunakan fungsi LoadLibrary dan GetProcAddress untuk menautkan secara dinamis ke Mssign32.dll.

Sintaks

BOOL WINAPI GetCryptProvFromCert(
  _In_      HWND           hwnd,
  _In_      PCCERT_CONTEXT pCert,
  _Out_     HCRYPTPROV     *phCryptProv,
  _Out_     DWORD          *pdwKeySpec,
  _In_      BOOL           *pfDidCryptAcquire,
  _Out_opt_ LPWSTR         *ppwszTmpContainer,
  _Out_opt_ LPWSTR         *ppwszProviderName,
  _Out_     DWORD          *pdwProviderType
);

Parameter

hwnd [in]: Gagang jendela yang akan digunakan sebagai pemilik kotak dialog apa pun yang ditampilkan. Anggota ini saat ini tidak digunakan dan diabaikan. Aman untuk meneruskan NULL untuk parameter ini.
pCert [in]: Penunjuk ke struktur CERT_CONTEXT untuk sertifikat.
phCryptProv [out]: Penunjuk ke struktur HCRYPTPROV yang merupakan handel ke CSP.
pdwKeySpec [out]: Spesifikasi kunci privat yang akan diambil. Nilai yang mungkin termasuk AT_KEYEXCHANGE atau AT_SIGNATURE.
pfDidCryptAcquire [in]: Nilai yang menentukan apakah fungsi memperoleh handel penyedia berdasarkan sertifikat.
ppwszTmpContainer [out, opsional]: Alamat penunjuk ke string yang dihentikan null untuk nama kontainer kunci sementara. Fungsi GetCryptProvFromCert menyediakan dan menginisialisasi kontainer sementara. Saat memanggil GetCryptProvFromCert, alamat harus menunjuk ke nilai NULL .
ppwszProviderName [out, opsional]: Alamat penunjuk ke string yang dihentikan null untuk nama penyedia. Fungsi GetCryptProvFromCert mengembalikan nama penyedia. Saat memanggil GetCryptProvFromCert, alamat harus menunjuk ke nilai NULL .
pdwProviderType [out]: Menentukan jenis CSP. Ini bisa menjadi nol atau salah satu Jenis Penyedia Kriptografi. Jika anggota ini nol, kontainer kunci adalah salah satu penyedia penyimpanan kunci CNG.

Menampilkan nilai

Setelah berhasil, fungsi ini mengembalikan TRUE. Fungsi GetCryptProvFromCert mengembalikan FALSE jika gagal.

Keterangan

Alat MakeCert memanggil GetCryptProvFromCert saat Anda memanggilnya dengan menggunakan opsi baris perintah -is .

Jika parameter pfDidCryptAcquire diatur ke TRUE, fungsi mengatur parameter phCryptProv, pdwKeySpec, dan pdwProviderType ke nilai penyedia.

Setelah Anda selesai menggunakan CSP, bebaskan dengan memanggil fungsi FreeCryptProvFromCert .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
DLL	Mssign32.dll

Bagikan melalui