Función TokenBindingGenerateBinding (tokenbinding.h)

Artículo
08/26/2023

Construye un enlace de token que contiene la clave pública exportada y la firma mediante el tipo de clave especificado para el enlace de tokens, una cadena de identificador de destino para crear y recuperar la clave de enlace del token y los datos únicos. Esta función también devuelve el identificador de enlace de tokens, si es necesario.

Sintaxis

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
);

Parámetros

[in] keyType

Tipo de clave negociado que se va a usar. Use un valor de la lista de tipos de clave que recuperó mediante una llamada a la función TokenBindingGetKeyTypesClient .

[in] targetURL

Cadena de destino que se va a usar junto con el tipo de clave para generar o recuperar una clave de enlace de token para las operaciones de NCrypt que compilan el búfer para el parámetro tokenBinding .

[in] bindingType

Tipo de enlace de token que debe generar TokenBindingGenerateBinding .

[in] tlsEKM

Puntero al búfer que contiene datos únicos.

[in] tlsEKMSize

Tamaño del búfer al que apunta el parámetro tlsUnique , en bytes.

[in] extensionFormat

Formato que se va a usar para interpretar los datos en el parámetro extensionData . Este valor debe ser TOKENBINDING_EXTENSION_FORMAT_UNDEFINED.

[in] extensionData

Puntero a un búfer que contiene datos de extensión. El valor del parámetro extensionFormat determina cómo interpretar estos datos.

[out] tokenBinding

Puntero que recibe la dirección del búfer de enlace de tokens. Use la función HeapAlloc para asignar la memoria de este búfer y la función HeapFree para liberar esa memoria.

[out] tokenBindingSize

Puntero a una variable que recibe el tamaño del búfer asignado para el parámetro tokenBinding , en bytes.

[out, optional] resultData

Puntero que recibe la dirección del búfer que contiene datos de resultados que incluye el identificador de enlace de tokens del enlace de tokens que genera TokenBindingGenerateBinding . Use la función HeapAlloc para asignar la memoria de este búfer y la función HeapFree para liberar esa memoria. Especifique NULL si no necesita esta información.

Valor devuelto

Devuelve un código de estado que indica el éxito o error de la función.

Comentarios

Puede llamar a TokenBindingGenerateBinding desde el modo de usuario.

Requisitos


Cliente mínimo compatible	Windows 10 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2016 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	tokenbinding.h
Library	Tokenbinding.lib
Archivo DLL	Tokenbinding.dll