PvkPrivateKeyAcquireContextFromMemory (Fungsi PvkPrivateKeyAcquireContextFromMemory)

Artikel
06/13/2023

Penting

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

Fungsi PvkPrivateKeyAcquireContextFromMemory membuat kontainer sementara di penyedia layanan kriptografi (CSP) dan memuat kunci privat dari memori ke dalam kontainer.

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 PvkPrivateKeyAcquireContextFromMemory(
  _In_        LPCWSTR    pwszProvName,
  _In_        DWORD      dwProvType,
  _In_        BYTE       *pbData,
  _In_        DWORD      cbData,
  _In_        HWND       hwndOwner,
  _In_        LPCWSTR    pwszKeyName,
  _Inout_opt_ DWORD      *pdwKeySpec,
  _Out_       HCRYPTPROV *phCryptProv,
  _Out_       LPTSTR     *ppwszTmpContainer
);

Parameter

pwszProvName [in]: Penunjuk ke string yang dihentikan null yang berisi nama CSP yang jenisnya diminta dalam dwProvType.
dwProvType [in]: Nilai DWORD untuk jenis CSP. Untuk informasi selengkapnya tentang jenis CSP, lihat Jenis Penyedia Kriptografi.
pbData [in]: Penunjuk ke buffer untuk menerima data konteks. Pemanggil harus menyediakan sumber daya ini.
cbData [in]: Nilai DWORD yang menentukan ukuran, dalam byte, dari buffer pbData . Pemanggil harus memberikan nilai ini.
hwndOwner [in]: Jika kata sandi diperlukan untuk mendekripsi data konteks yang diarahkan oleh parameter pbData , parameter ini adalah handel ke induk kotak dialog; jika tidak, itu NULL.
pwszKeyName [in]: Penunjuk ke string yang dihentikan null yang berisi nama kunci yang akan diambil.
pdwKeySpec [masuk, keluar, opsional]: Penunjuk ke nilai DWORD yang menentukan jenis kunci. Nilai yang mungkin termasuk AT_KEYEXCHANGE atau AT_SIGNATURE.
phCryptProv [out]: Penunjuk ke handel untuk CSP.
ppwszTmpContainer [out]: Alamat penunjuk ke string yang dihentikan null untuk nama kontainer sementara. Fungsi PvkPrivateKeyAcquireContextFromMemory menyediakan buffer untuk string ini dan menginisialisasinya. Saat memanggil PvkPrivateKeyAcquireContextFromMemory, alamat harus menunjuk ke nilai NULL .

Menampilkan nilai

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

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