Fungsi PFXVerifyPassword (wincrypt.h)

Fungsi PFXVerifyPassword mencoba mendekode lapisan luar blob sebagai paket Pertukaran Informasi Pribadi (PFX) dan untuk mendekripsinya dengan kata sandi yang diberikan. Tidak ada data dari BLOB yang diimpor.

Format PFX juga dikenal sebagai format Standar Kriptografi Public-Key #12 (PKCS #12).

Sintaks

BOOL PFXVerifyPassword(
  [in] CRYPT_DATA_BLOB *pPFX,
  [in] LPCWSTR         szPassword,
  [in] DWORD           dwFlags
);

Parameter

[in] pPFX

Penunjuk ke struktur CRYPT_DATA_BLOB bahwa fungsi akan mencoba mendekode sebagai paket PFX.

[in] szPassword

Kata sandi string yang akan diperiksa. Agar fungsi ini berhasil, kata sandi ini harus sama persis dengan kata sandi yang digunakan untuk mengenkripsi paket.

Jika Anda mengatur nilai ini ke string kosong atau NULL, fungsi ini biasanya mencoba mendekripsi kata sandi yang disematkan di BLOB PFX dengan menggunakan string kosong atau NULL.

Namun, dimulai dengan Windows 8 dan Windows Server 2012, jika NULL atau kata sandi kosong ditentukan ketika BLOB PFX dibuat dan aplikasi juga menentukan bahwa kata sandi harus dilindungi ke perwakilan Direktori Aktif (AD), API Kriptografi (CAPI) secara acak menghasilkan kata sandi, mengenkripsinya ke perwakilan AD dan menyematkannya di BLOB PFX. Fungsi PFXVerifyPassword kemudian akan mencoba menggunakan prinsip ad yang ditentukan (pengguna saat ini, komputer, atau anggota grup AD) untuk mendekripsi kata sandi. Untuk informasi selengkapnya tentang melindungi PFX ke perwakilan AD, lihat parameter pvPara dan bendera PKCS12_PROTECT_TO_DOMAIN_SIDS fungsi PFXExportCertStoreEx .

Setelah Anda selesai menggunakan kata sandi, hapus kata sandi dari memori dengan memanggil fungsi SecureZeroMemory . Untuk informasi selengkapnya tentang melindungi kata sandi, lihat Menangani Kata Sandi.

[in] dwFlags

Disiapkan untuk penggunaan masa mendatang.

Nilai kembali

Fungsi mengembalikan TRUE jika kata sandi tampak benar; jika tidak, ia mengembalikan FALSE.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	wincrypt.h
Pustaka	Crypt32.lib
DLL	Crypt32.dll