Função PFXVerifyPassword (wincrypt.h)

  • Artigo

A função PFXVerifyPassword tenta decodificar a camada externa de um blob como um pacote PFX (Troca de Informações Pessoais) e descriptografá-la com a senha fornecida. Nenhum dado do BLOB é importado.

O formato PFX também é conhecido como o formato Public-Key Cryptography Standards nº 12 (PKCS #12).

Sintaxe

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

Parâmetros

[in] pPFX

Um ponteiro para uma estrutura CRYPT_DATA_BLOB que a função tentará decodificar como um pacote PFX.

[in] szPassword

Senha de cadeia de caracteres a ser verificada. Para que essa função tenha êxito, essa senha deve ser exatamente a mesma que a senha usada para criptografar o pacote.

Se você definir esse valor como uma cadeia de caracteres vazia ou NULL, essa função normalmente tentará descriptografar a senha inserida no BLOB PFX usando a cadeia de caracteres vazia ou NULL.

No entanto, começando com Windows 8 e Windows Server 2012, se uma senha NULL ou vazia foi especificada quando o BLOB PFX foi criado e o aplicativo também especificou que a senha deve ser protegida para uma entidade de segurança do Active Directory (AD), a CAPI (API de Criptografia) gera aleatoriamente uma senha, criptografa-a para a entidade de segurança do AD e a insere no BLOB PFX. A função PFXVerifyPassword tentará usar a entidade de segurança do AD especificada (usuário atual, computador ou membro do grupo do AD) para descriptografar a senha. Para obter mais informações sobre como proteger o PFX para uma entidade de segurança do AD, consulte o parâmetro pvPara e o sinalizador PKCS12_PROTECT_TO_DOMAIN_SIDS da função PFXExportCertStoreEx .

Quando terminar de usar a senha, desmarque a senha da memória chamando a função SecureZeroMemory . Para obter mais informações sobre como proteger senhas, consulte Manipulando senhas.

[in] dwFlags

Reservado para uso futuro.

Retornar valor

A função retornará TRUE se a senha aparecer correta; caso contrário, retornará FALSE.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho wincrypt.h
Biblioteca Crypt32.lib
DLL Crypt32.dll