TokenBindingGenerateID-Funktion (tokenbinding.h)

Erstellt den Tokenbindungsbezeichner, indem der Signaturalgorithmus aus dem Schlüsseltyp extrahiert und der exportierte öffentliche Schlüssel kopiert wird.

Syntax

SECURITY_STATUS TokenBindingGenerateID(
  [in]  TOKENBINDING_KEY_PARAMETERS_TYPE keyType,
  [in]  const void                       *publicKey,
  [in]  DWORD                            publicKeySize,
  [out] TOKENBINDING_RESULT_DATA         **resultData
);

Parameter

[in] keyType

Der zu verwendende ausgehandelte Schlüsseltyp. Verwenden Sie einen Wert aus der Liste der Schlüsseltypen, die Sie durch Aufrufen der Funktion TokenBindingGetKeyTypesClient abgerufen haben.

[in] publicKey

Ein exportiertes Blob mit öffentlichem Schlüssel.

[in] publicKeySize

Die Größe des exportierten Blobs für öffentliche Schlüssel.

[out] resultData

Ein Zeiger, der die Adresse des Puffers empfängt, der für die Ergebnisdaten der Tokenbindung zugeordnet ist. Die Ergebnisdaten der Tokenbindung enthalten den Tokenbindungsbezeichner.

Verwenden Sie die HeapAlloc-Funktion , um den Arbeitsspeicher für diesen Puffer zuzuweisen, und die HeapFree-Methode , um diesen Speicher freizugeben.

Rückgabewert

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

Hinweise

Sie können TokenBindingGenerateID 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