Funzione CryptImportPublicKeyInfoEx2 (wincrypt.h)

Articolo
07/16/2024

La funzione CryptImportPublicKeyInfoEx2 importa una chiave pubblica nel provider asimmetrico CNG che corrisponde alla chiave pubblica identificatore di oggetto (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

Il tipo di codifica del certificato utilizzato per crittografare l'oggetto. Il tipo di codifica messaggio identificatore, contenuto nell' word elevato di questo valore, viene ignorato da questa funzione.

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

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

[in] pInfo

Indirizzo di una struttura di CERT_PUBLIC_KEY_INFO che contiene le informazioni sulla chiave pubblica da importare nel provider.

[in] dwFlags

Set di flag che modificano il comportamento di questa funzione. 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 di CRYPT_PUBKEY_ALG_OID_GROUP_ID contrassegnate in modo esplicito con il flag CRYPT_OID_PUBKEY_SIGN_ONLY_FLAG.

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

[in] pvAuxInfo

Questo parametro è riservato per 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 un valore diverso da zero (TRUE).

Se la funzione ha esito negativo, restituisce zero (FALSE). Per informazioni sugli errori estesi, chiamare GetLastError. I codici di errore possibili includono, ma non solo, quanto segue.

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

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [app desktop \| App UWP]
server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
piattaforma di destinazione	Finestre
intestazione	wincrypt.h
libreria	Crypt32.lib
dll	Crypt32.dll

Vedere anche

CERT_PUBLIC_KEY_INFO

Condividi tramite