Fungsi PvkGetCryptProv

Artikel
06/13/2023

Penting

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

Fungsi PvkGetCryptProv mendapatkan handel ke penyedia layanan kriptografi (CSP) berdasarkan file kunci privat atau nama kontainer kunci.

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

HRESULT WINAPI PvkGetCryptProv(
  _In_      HWND       hwnd,
  _In_      LPCWSTR    pwszCaption,
  _In_      LPCWSTR    pwszCapiProvider,
  _In_      DWORD      dwProviderType,
  _In_      LPCWSTR    pwszPvkFile,
  _In_      LPCWSTR    pwszKeyContainerName,
  _Out_     DWORD      *pdwKeySpec,
  _Out_opt_ LPWSTR     *ppwszTmpContainer,
  _Out_     HCRYPTPROV *phCryptProv
);

Parameter

hwnd [in]: Jika kata sandi diperlukan untuk mendekripsi file kunci privat, parameter ini adalah handel ke induk kotak dialog kata sandi; jika tidak, null.
pwszCaption [in]: Penunjuk ke string yang dihentikan null untuk kotak dialog caption.
pwszCapiProvider [in]: Penunjuk ke string yang dihentikan null untuk nama CSP.
dwProviderType [in]: Nilai DWORD yang mewakili jenis penyedia kriptografi. Untuk informasi selengkapnya, lihat Jenis Penyedia Kriptografi.
pwszPvkFile [in]: Penunjuk ke string yang dihentikan null yang berisi nama file kunci privat.
pwszKeyContainerName [in]: Penunjuk ke string yang dihentikan null untuk nama kontainer kunci privat.
pdwKeySpec [out]: Pointer ke nilai DWORD untuk jenis kunci kontainer yang dikembalikan dengan phCryptProv dan ppwszTmpContainer.
ppwszTmpContainer [out, opsional]: Alamat penunjuk ke string yang dihentikan null untuk nama kontainer kunci sementara. Fungsi PvkGetCryptProv menyediakan dan menginisialisasi kontainer sementara. Saat memanggil PvkGetCryptProv, alamat harus menunjuk ke nilai NULL .
phCryptProv [out]: Penunjuk ke handel untuk CSP.

Menampilkan nilai

Jika metode berhasil, metode akan mengembalikan S_OK.

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

Keterangan

Fungsi PvkGetCryptProv pertama kali mencoba mendapatkan handel penyedia dari nama kontainer kunci yang ditentukan oleh parameter pwszKeyContainerName . Jika Anda meneruskan NULL untuk parameter pwszKeyContainerName , PvkGetCryptProv mencoba mendapatkan penyedia dari file kunci privat yang ditentukan dalam parameter pwszPvkFile .

Setelah Anda selesai menggunakan CSP, bebaskan handel penyedia dan kontainer kunci sementara dengan memanggil fungsi PvkFreeCryptProv .

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