PFN_IMPORT_PUBLIC_KEY_INFO_EX2_FUNC funzione di callback (wincrypt.h)

Articolo
08/27/2023

La funzione di callback PFN_IMPORT_PUBLIC_KEY_INFO_EX2_FUNC viene chiamata da CryptImportPublicKeyInfoEx2 per decodificare l'identificatore dell'algoritmo di chiave pubblica , caricare il provider di algoritmi e importare la coppia di chiavi.

Sintassi

PFN_IMPORT_PUBLIC_KEY_INFO_EX2_FUNC PfnImportPublicKeyInfoEx2Func;

BOOL PfnImportPublicKeyInfoEx2Func(
  [in]  DWORD dwCertEncodingType,
  [in]  PCERT_PUBLIC_KEY_INFO pInfo,
  [in]  DWORD dwFlags,
  [in]  void *pvAuxInfo,
  [out] BCRYPT_KEY_HANDLE *phKey
)
{...}

Parametri

[in] dwCertEncodingType

Tipo di codifica del certificato usato per crittografare l'oggetto. L'identificatore del tipo di codifica del messaggio , contenuto nell'alto WORD di questo valore, viene ignorato da questa funzione.

Questo parametro può essere il seguente tipo di codifica del certificato attualmente definito.

Valore	Significato
X509_ASN_ENCODING 1 (0x1)	Specifica la codifica del certificato X.509 .

[in] pInfo

Puntatore a una struttura CERT_PUBLIC_KEY_INFO contenente le informazioni sulla chiave pubblica da importare nel provider.

[in] dwFlags

Set di flag che modificano il comportamento di questa funzione. Questo può essere zero.

[in] pvAuxInfo

Questo parametro è riservato per l'uso futuro e deve essere impostato su NULL.

[out] phKey

Puntatore a una variabile BCRYPT_KEY_HANDLE che riceve l'handle della chiave importata.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce non zero (TRUE).

Se la funzione ha esito negativo, restituisce zero (FALSE). Per informazioni sull'errore estese, chiamare GetLastError.

Commenti

È possibile usare funzioni di supporto OID per distribuire questa funzione di callback. Wincrypt.h definisce la costante seguente per questo scopo.

Costante	Definizione
CRYPT_OID_IMPORT_PUBLIC_KEY_INFO_EX2_FUNC	"CryptDllImportPublicKeyInfoEx2"

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wincrypt.h