Função TokenBindingGenerateBinding (tokenbinding.h)
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 |