SslGenerateSessionKeys fonction)
La fonction SslGenerateSessionKeys génère un ensemble de clés de session de protocole SSL (Secure Sockets Layer) (SSL).
Syntaxe
SECURITY_STATUS WINAPI SslGenerateSessionKeys(
_In_ NCRYPT_PROV_HANDLE hSslProvider,
_In_ NCRYPT_KEY_HANDLE hMasterKey,
_Out_ NCRYPT_KEY_HANDLE *phReadKey,
_Out_ NCRYPT_KEY_HANDLE *phWriteKey,
_In_ PNCryptBufferDesc pParameterList,
_In_ DWORD dwFlags
);
Paramètres
-
hSslProvider [ dans]
-
Handle de l’instance du fournisseur de protocole SSL.
-
hMasterKey [ dans]
-
Handle de l’objet de clé principale .
-
phReadKey [ à]
-
Pointeur vers le handle de la clé de lecture retournée.
-
phWriteKey [ à]
-
Pointeur vers le handle de clé d’écriture retourné.
-
pParameterList [ dans]
-
Pointeur vers un tableau de mémoires tampons NCryptBuffer qui contiennent des informations utilisées dans le cadre de l’opération d’échange de clés. L’ensemble précis de mémoires tampons dépend du protocole et de la suite de chiffrement utilisés. Au minimum, la liste contient des mémoires tampons qui contiennent les valeurs aléatoires fournies par le client et le serveur.
-
dwFlags [ dans]
-
Ce paramètre est réservé à un usage futur.
Valeur de retour
Si la fonction est réussie, 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, mais ne sont pas limités à, les éléments suivants.
| Code/valeur de retour | Description |
|---|---|
|
La mémoire disponible est insuffisante pour allouer les tampons nécessaires. |
|
L’un des handles fournis n’est pas valide. |
|
Le paramètre phReadKey ou phWriteKey a la valeur null. |
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
applications de [ bureau Windows Vista uniquement] |
| Serveur minimal pris en charge |
applications de bureau Windows Server 2008 [ uniquement] |
| En-tête |
|
| DLL |
|