TokenBindingGenerateMessage-Funktion (tokenbinding.h)

Stellt die Liste der Tokenbindungen zusammen und generiert die endgültige Nachricht für das Clientgerät an den Server.

Syntax

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

Parameter

[in] tokenBindings

Zeiger auf ein Array von Tokenbindungsstrukturen.

[in] tokenBindingsSize

Ein Array, das die Größen der entsprechenden Tokenbindungsstrukturen enthält, die das Array im tokenBindings-Parameter enthält, in Bytes.

[in] tokenBindingsCount

Die Anzahl der Elemente, die das Array im tokenBindings-Parameter enthält. Dieser Wert darf nicht 0 sein.

[out] tokenBindingMessage

Ein Zeiger, der die Adresse des Puffers empfängt, der für die Tokenbindungsnachricht zugewiesen ist. Verwenden Sie die HeapAlloc-Funktion , um den Arbeitsspeicher für diesen Puffer zuzuweisen, und die HeapFree-Methode , um diesen Arbeitsspeicher freizugeben.

[out] tokenBindingMessageSize

Ein Zeiger auf eine Variable, die die Größe des Puffers enthält, der dem TokenBindingMessage-Parameter zugeordnet ist.

Rückgabewert

Gibt einen status Code zurück, der den Erfolg oder Fehler der Funktion angibt.

Hinweise

Sie können TokenBindingGenerateMessage aus dem Benutzermodus aufrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	tokenbinding.h
Bibliothek	Tokenbinding.lib
DLL	Tokenbinding.dll

Weitere Informationen

HeapAlloc

HeapFree

TokenBindingVerifyMessage