Funzione PFXVerifyPassword (wincrypt.h)

  • Articolo

La funzione PFXVerifyPassword tenta di decodificare il livello esterno di un BLOB come pacchetto PFX (Personal Information Exchange) e di decrittografarlo con la password specificata. Non viene importato alcun dato dal BLOB.

Il formato PFX è noto anche come formato Public-Key standard di crittografia #12 (PKCS #12).

Sintassi

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

Parametri

[in] pPFX

Puntatore a una struttura CRYPT_DATA_BLOB che la funzione tenterà di decodificare come pacchetto PFX.

[in] szPassword

Password stringa da controllare. Affinché questa funzione abbia esito positivo, questa password deve essere esattamente la stessa della password usata per crittografare il pacchetto.

Se si imposta questo valore su una stringa vuota o NULL, questa funzione tenta in genere di decrittografare la password incorporata nel BLOB PFX usando la stringa vuota o NULL.

Tuttavia, a partire da Windows 8 e Windows Server 2012, se è stata specificata una password NULL o vuota quando è stato creato il BLOB PFX e l'applicazione ha specificato anche che la password deve essere protetta in un'entità di Active Directory (AD), l'API di crittografia (CAPI) genera in modo casuale una password, la crittografa nell'entità AD e la incorpora nel BLOB PFX. La funzione PFXVerifyPassword tenterà quindi di usare l'entità AD specificata (utente corrente, computer o membro del gruppo DI AD) per decrittografare la password. Per altre informazioni sulla protezione di PFX in un'entità di Active Directory, vedere il parametro pvPara e il flag PKCS12_PROTECT_TO_DOMAIN_SIDS della funzione PFXExportCertStoreEx .

Al termine dell'uso della password, cancellare la password dalla memoria chiamando la funzione SecureZeroMemory . Per altre informazioni sulla protezione delle password, vedere Gestione delle password.

[in] dwFlags

Riservato per utilizzi futuri.

Valore restituito

La funzione restituisce TRUE se la password appare corretta; in caso contrario, restituisce FALSE.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [app desktop | App UWP]
Server minimo supportato Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione wincrypt.h
Libreria Crypt32.lib
DLL Crypt32.dll