SslImportKey, fonction

Article
06/12/2023

La fonction SslImportKey importe une clé dans le fournisseur de protocole SSL ( Secure Sockets Layer Protocol).

Syntaxe

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
);

Paramètres

hSslProvider [in]

Handle du fournisseur de protocole SSL instance.

phKey [out]

Pointeur vers le handle de la clé de chiffrement pour recevoir la clé importée.

pszBlobType [in]

Chaîne Unicode terminée par un caractère Null qui contient un identificateur qui spécifie le type d’objet BLOB contenu dans la mémoire tampon pbInput . Il peut s’agir de l’une des valeurs suivantes.

Valeur	Signification
BCRYPT_DH_PUBLIC_BLOB	Exporter une clé publique Diffie-Hellman. La mémoire tampon pbOutput reçoit une structure BCRYPT_DH_KEY_BLOB immédiatement suivie des données de clé.
BCRYPT_ECCPUBLIC_BLOB	Exportez une clé publique ECC (Elliptic Curve Cryptography). La mémoire tampon pbOutput reçoit une structure BCRYPT_ECCKEY_BLOB immédiatement suivie des données de clé.
BCRYPT_OPAQUE_KEY_BLOB	Exportez une clé symétrique dans un format spécifique à un fournisseur de services de chiffrement (CSP). Les objets BLOB opaques ne sont pas transférables et doivent être importés à l’aide du fournisseur de solutions Cloud qui a généré l’objet BLOB.
BCRYPT_RSAPUBLIC_BLOB	Exporter une clé publique RSA . La mémoire tampon pbOutput reçoit une structure BCRYPT_RSAKEY_BLOB immédiatement suivie des données de clé.

pbKeyBlob [in]

Pointeur vers la mémoire tampon qui contient l’objet BLOB clé.

cbKeyBlob [in]

Taille, en octets, de la mémoire tampon pbKeyBlob .

dwFlags [in]

Ce paramètre est réservé à un usage futur.

Valeur retournée

Si la fonction réussit, elle retourne zéro.

Si la fonction échoue, elle retourne une valeur d’erreur différente de zéro.

Les codes de retour possibles incluent, sans s’y limiter, les éléments suivants.

Code/valeur de retour	Description
NTE_NO_MEMORY 0x8009000EL	La mémoire disponible est insuffisante pour allouer les mémoires tampons nécessaires.
NTE_INVALID_HANDLE 0x80090026L	Le handle hSslProvider n’est pas valide.
NTE_INVALID_PARAMETER 0x80090027L	Le paramètre phKey est NULL.

Notes

Vous pouvez utiliser la fonction SslImportKey pour importer des clés de session dans le cadre du processus de transfert des clés de session d’un processus à un autre.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	Sslprovider.h
DLL	Ncrypt.dll