Função TokenBindingGenerateBinding (tokenbinding.h)

Artigo
08/26/2023

Constrói uma associação de token que contém a chave pública exportada e a assinatura usando o tipo de chave especificado para a associação de token, uma cadeia de caracteres de identificador de destino para criar e recuperar a chave de associação de token e os dados exclusivos. Essa função também retorna o identificador de associação de token, se necessário.

Sintaxe

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

O tipo de chave negociado a ser usado. Use um valor da lista de tipos de chave que você recuperou chamando a função TokenBindingGetKeyTypesClient .

[in] targetURL

A cadeia de caracteres de destino a ser usada em conjunto com o tipo de chave para gerar ou recuperar uma chave de associação de token para as operações NCrypt que criam o buffer para o parâmetro tokenBinding .

[in] bindingType

O tipo de associação de token que TokenBindingGenerateBinding deve gerar.

[in] tlsEKM

Um ponteiro para o buffer que contém dados exclusivos.

[in] tlsEKMSize

O tamanho do buffer para o qual o parâmetro tlsUnique aponta, em bytes.

[in] extensionFormat

O formato a ser usado para interpretar os dados no parâmetro extensionData . Esse valor deve ser TOKENBINDING_EXTENSION_FORMAT_UNDEFINED.

[in] extensionData

Um ponteiro para um buffer que contém dados de extensão. O valor do parâmetro extensionFormat determina como interpretar esses dados.

[out] tokenBinding

Um ponteiro que recebe o endereço do buffer de associação de token. Use a função HeapAlloc para alocar a memória para esse buffer e a função HeapFree para liberar essa memória.

[out] tokenBindingSize

Ponteiro para uma variável que recebe o tamanho do buffer alocado para o parâmetro tokenBinding , em bytes.

[out, optional] resultData

Um ponteiro que recebe o endereço do buffer que contém dados de resultado que inclui o identificador de associação de token da associação de token gerada por TokenBindingGenerateBinding . Use a função HeapAlloc para alocar a memória para esse buffer e a função HeapFree para liberar essa memória. Especificar NULL é que você não precisa dessas informações.

Valor retornado

Retorna um código status que indica o êxito ou a falha da função.

Comentários

Você pode chamar TokenBindingGenerateBinding do modo de usuário.

Requisitos


Cliente mínimo com suporte	Windows 10 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2016 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	tokenbinding.h
Biblioteca	Tokenbinding.lib
DLL	Tokenbinding.dll