Partager via


Fonction TokenBindingGenerateMessage (tokenbinding.h)

Assemble la liste des liaisons de jetons et génère le message final de l’appareil client au serveur.

Syntaxe

SECURITY_STATUS TokenBindingGenerateMessage(
  [in]  const void * [] tokenBindings,
  [in]  const DWORD []  tokenBindingsSize,
  [in]  DWORD           tokenBindingsCount,
  [out] void            **tokenBindingMessage,
  [out] DWORD           *tokenBindingMessageSize
);

Paramètres

[in] tokenBindings

Pointeur vers un tableau de structures de liaison de jetons.

[in] tokenBindingsSize

Tableau qui contient les tailles des structures de liaison de jeton correspondantes que le tableau du paramètre tokenBindings contient, en octets.

[in] tokenBindingsCount

Nombre d’éléments que le tableau dans le paramètre tokenBindings contient. Cette valeur ne peut pas être 0.

[out] tokenBindingMessage

Pointeur qui reçoit l’adresse de la mémoire tampon allouée pour le message de liaison de jeton. Utilisez la fonction HeapAlloc pour allouer la mémoire pour cette mémoire tampon et la méthode HeapFree pour libérer cette mémoire.

[out] tokenBindingMessageSize

Pointeur vers une variable qui contient la taille de la mémoire tampon allouée pour le paramètre tokenBindingMessage .

Valeur retournée

Retourne un code status qui indique la réussite ou l’échec de la fonction.

Remarques

Vous pouvez appeler TokenBindingGenerateMessage à partir du mode utilisateur.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10 (applications de bureau uniquement)
Serveur minimal pris en charge Windows Server 2016 (applications de bureau uniquement)
Plateforme cible Windows
En-tête tokenbinding.h
Bibliothèque Tokenbinding.lib
DLL Tokenbinding.dll

Voir aussi

HeapAlloc

HeapFree

TokenBindingVerifyMessage