Funzione TokenBindingGenerateBinding (tokenbinding.h)

Articolo
08/26/2023

Costruisce un'associazione di token che contiene la chiave pubblica esportata e la firma usando il tipo di chiave specificato per l'associazione di token, una stringa di identificatore di destinazione per la creazione e il recupero della chiave di associazione del token e i dati univoci. Questa funzione restituisce anche l'identificatore di associazione del token, se necessario.

Sintassi

SECURITY_STATUS TokenBindingGenerateBinding(
  [in]            TOKENBINDING_KEY_PARAMETERS_TYPE keyType,
  [in]            PCWSTR                           targetURL,
  [in]            TOKENBINDING_TYPE                bindingType,
  [in]            const void                       *tlsEKM,
  [in]            DWORD                            tlsEKMSize,
  [in]            TOKENBINDING_EXTENSION_FORMAT    extensionFormat,
  [in]            const void                       *extensionData,
  [out]           void                             **tokenBinding,
  [out]           DWORD                            *tokenBindingSize,
  [out, optional] TOKENBINDING_RESULT_DATA         **resultData
);

Parametri

[in] keyType

Tipo di chiave negoziata da utilizzare. Usare un valore dall'elenco dei tipi di chiave recuperati chiamando la funzione TokenBindingGetKeyTypesClient .

[in] targetURL

Stringa di destinazione da usare in combinazione con il tipo di chiave per generare o recuperare una chiave di associazione del token per le operazioni NCrypt che compilano il buffer per il parametro tokenBinding .

[in] bindingType

Tipo di associazione di token che deve essere generato da TokenBindingGenerateBinding .

[in] tlsEKM

Puntatore al buffer che contiene dati univoci.

[in] tlsEKMSize

Dimensione del buffer a cui punta il parametro tlsUnique , in byte.

[in] extensionFormat

Formato da utilizzare per interpretare i dati nel parametro extensionData . Questo valore deve essere TOKENBINDING_EXTENSION_FORMAT_UNDEFINED.

[in] extensionData

Puntatore a un buffer contenente dati di estensione. Il valore del parametro extensionFormat determina come interpretare questi dati.

[out] tokenBinding

Puntatore che riceve l'indirizzo del buffer di associazione del token. Usare la funzione HeapAlloc per allocare la memoria per questo buffer e la funzione HeapFree per liberare tale memoria.

[out] tokenBindingSize

Puntatore a una variabile che riceve le dimensioni del buffer allocato per il parametro tokenBinding , in byte.

[out, optional] resultData

Puntatore che riceve l'indirizzo del buffer contenente i dati dei risultati che include l'identificatore di associazione del token dell'associazione di token generata da TokenBindingGenerateBinding . Usare la funzione HeapAlloc per allocare la memoria per questo buffer e la funzione HeapFree per liberare tale memoria. Specificare NULL non sono necessarie queste informazioni.

Valore restituito

Restituisce un codice di stato che indica l'esito positivo o negativo della funzione.

Commenti

È possibile chiamare TokenBindingGenerateBinding dalla modalità utente.

Requisiti


Client minimo supportato	Windows 10 [solo app desktop]
Server minimo supportato	Windows Server 2016 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	tokenbinding.h
Libreria	Tokenbinding.lib
DLL	Tokenbinding.dll