Функция PFXVerifyPassword (wincrypt.h)

  • Статья

Функция PFXVerifyPassword пытается декодировать внешний слой большого двоичного объекта как пакет обмена личной информацией (PFX) и расшифровать его с помощью заданного пароля. Данные из большого двоичного объекта не импортируются.

Формат PFX также называется форматом Public-Key стандартов шифрования No 12 (PKCS 12).

Синтаксис

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

Параметры

[in] pPFX

Указатель на структуру CRYPT_DATA_BLOB , которую функция попытается декодировать как пакет PFX.

[in] szPassword

Проверяемый строковый пароль. Для успешного выполнения этой функции этот пароль должен совпадать с паролем, используемым для шифрования пакета.

Если для этого значения задана пустая строка или NULL, эта функция обычно пытается расшифровать пароль, внедренный в большой двоичный объект PFX, с помощью пустой строки или NULL.

Однако начиная с Windows 8 и Windows Server 2012, если при создании большого двоичного объекта PFX был указан пустой или пустой пароль, а приложение также указало, что пароль должен быть защищен субъектом Active Directory (AD), API шифрования (CAPI) случайным образом создает пароль, шифрует его в субъекте AD и внедряет в большой двоичный объект PFX. Затем функция PFXVerifyPassword попытается использовать указанный субъект AD (текущий пользователь, компьютер или член группы AD) для расшифровки пароля. Дополнительные сведения о защите PFX для субъекта AD см. в параметре pvPara и флаге PKCS12_PROTECT_TO_DOMAIN_SIDS функции PFXExportCertStoreEx .

Завершив использование пароля, очистите пароль из памяти, вызвав функцию SecureZeroMemory . Дополнительные сведения о защите паролей см. в разделе Обработка паролей.

[in] dwFlags

Зарезервировано для последующего использования.

Возвращаемое значение

Функция возвращает значение TRUE , если пароль отображается правильно; в противном случае возвращается значение FALSE.

Требования

Требование Значение
Минимальная версия клиента Windows XP [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2003 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header wincrypt.h
Библиотека Crypt32.lib
DLL Crypt32.dll