SslImportKey, fonction
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 |
---|---|
|
La mémoire disponible est insuffisante pour allouer les mémoires tampons nécessaires. |
|
Le handle hSslProvider n’est pas valide. |
|
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 |
|
DLL |
|