Funzione SslImportKey

Articolo
06/12/2023

La funzione SslImportKey importa una chiave nel provider di protocollo SSL (Secure Sockets Layer Protocol ).

Sintassi

SECURITY_STATUS WINAPI SslImportKey(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _Out_ NCRYPT_KEY_HANDLE  *phKey,
  _In_  LPCWSTR            pszBlobType,
  _In_  PBYTE              pbKeyBlob,
  _In_  DWORD              cbKeyBlob,
  _In_  DWORD              dwFlags
);

Parametri

hSslProvider [in]

Handle all'istanza del provider di protocolli SSL.

phKey [out]

Puntatore all'handle della chiave crittografica per ricevere la chiave importata.

pszBlobType [in]

Stringa Unicode con terminazione null contenente un identificatore che specifica il tipo di BLOB contenuto nel buffer pbInput . Questo può essere uno dei valori seguenti.

Valore	Significato
BCRYPT_DH_PUBLIC_BLOB	Esportare una chiave pubblica Diffie-Hellman. Il buffer pbOutput riceve una struttura BCRYPT_DH_KEY_BLOB immediatamente seguita dai dati chiave.
BCRYPT_ECCPUBLIC_BLOB	Esportare una chiave pubblica ecc (elliptic curve cryptography). Il buffer pbOutput riceve una struttura BCRYPT_ECCKEY_BLOB immediatamente seguita dai dati chiave.
BCRYPT_OPAQUE_KEY_BLOB	Esportare una chiave simmetrica in un formato specifico di un singolo provider di servizi di crittografia . I BLOB opachi non sono trasferiscibili e devono essere importati usando lo stesso CSP che ha generato il BLOB.
BCRYPT_RSAPUBLIC_BLOB	Esportare una chiave pubblica RSA . Il buffer pbOutput riceve una struttura BCRYPT_RSAKEY_BLOB immediatamente seguita dai dati chiave.

pbKeyBlob [in]

Puntatore al buffer contenente il BLOB della chiave.

cbKeyBlob [in]

Dimensioni, in byte, del buffer pbKeyBlob .

dwFlags [in]

Questo parametro è riservato per usi futuri.

Valore restituito

Se la funzione ha esito positivo, restituisce zero.

Se la funzione ha esito negativo, restituisce un valore di errore diverso da zero.

I codici restituiti possibili includono, ma non sono limitati a, i seguenti.

Codice/valore restituito	Descrizione
NTE_NO_MEMORY 0x8009000EL	Memoria insufficiente è disponibile per allocare i buffer necessari.
NTE_INVALID_HANDLE 0x80090026L	L'handle hSslProvider non è valido.
NTE_INVALID_PARAMETER 0x80090027L	Il parametro phKey è NULL.

Commenti

È possibile usare la funzione SslImportKey per importare chiavi di sessione come parte del processo di trasferimento delle chiavi di sessione da un processo a un altro.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	Sslprovider.h
DLL	Ncrypt.dll

Condividi tramite