Funzione CryptImportPublicKeyInfoEx2 (wincrypt.h)

  • Articolo

La funzione CryptImportPublicKeyInfoEx2 importa una chiave pubblica nel provider asimmetrico CNG che corrisponde all'identificatore dell'oggetto chiave pubblica (OID) e restituisce un handle CNG alla chiave.

Sintassi

BOOL CryptImportPublicKeyInfoEx2(
  [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

Indirizzo di 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 o una combinazione di uno o più dei valori seguenti.

Valore Significato
CRYPT_OID_INFO_PUBKEY_SIGN_KEY_FLAG
 Ignora le chiavi pubbliche nel gruppo CRYPT_PUBKEY_ALG_OID_GROUP_ID contrassegnate in modo esplicito con il flag CRYPT_OID_PUBKEY_ENCRYPT_ONLY_FLAG.
CRYPT_OID_INFO_PUBKEY_ENCRYPT_KEY_FLAG
 Ignora le chiavi pubbliche nel gruppo CRYPT_PUBKEY_ALG_OID_GROUP_ID contrassegnato in modo esplicito con il flag CRYPT_OID_PUBKEY_SIGN_ONLY_FLAG.
 

Questi flag vengono passati nel parametro dwKeyType della funzione CryptFindOIDInfo durante il mapping dell'identificatore dell'oggetto chiave pubblica corrispondente all'identificatore dell'algoritmo di chiave pubblica CNG corrispondente.

[in] pvAuxInfo

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

[out] phKey

Indirizzo di una variabile BCRYPT_KEY_HANDLE che riceve l'handle della chiave importata.

Quando questo handle non è più necessario, è necessario rilasciarlo chiamando la funzione BCryptDestroyKey .

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. I codici di errore possibili includono, ma non sono limitati a, quanto segue.

Codice restituito Descrizione
ERROR_FILE_NOT_FOUND
 Impossibile trovare una funzione di importazione che può essere installata o registrata per i parametri dwCertEncodingType e pInfo specificati.
E_INVALIDARG
 Uno o più parametri non sono validi.

Requisiti

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

Vedi anche

CERT_PUBLIC_KEY_INFO