TokenBindingGenerateMessage function

Assembles the list of token bindings and generates the final message for the client device to the server.

Syntax


SECURITY_STATUS WINAPI TokenBindingGenerateMessage(
  _In_  const void  *tokenBindings[ ],
  _In_  const DWORD tokenBindingsSize[ ],
  _In_        DWORD tokenBindingsCount,
  _Out_       void  **tokenBindingMesssage,
  _Out_       DWORD *tokenBindingMessageSize
);

Parameters

tokenBindings [in]

Pointer to an array of token binding structures.

tokenBindingsSize [in]

An array that contains the sizes of the corresponding token binding structures that the array in the tokenBindings parameter contains, in bytes.

tokenBindingsCount [in]

The number of elements that the array in the tokenBindings parameter contains. This value cannot be 0.

tokenBindingMesssage [out]

A pointer that receives the address of the buffer that is allocated for the token binding message. Use the HeapAlloc function to allocate the memory for this buffer, and the HeapFree method to free that memory.

tokenBindingMessageSize [out]

A pointer to a variable that contains the size of the buffer allocated for the tokenBindingMessage parameter.

Return value

Returns a status code that indicates the success or failure of the function.

Remarks

You can call TokenBindingGenerateMessage from user mode.

Requirements

Minimum supported client

Windows 10 [desktop apps only]

Minimum supported server

Windows Server 2016 [desktop apps only]

Header

Tokenbinding.h

Library

Tokenbinding.lib

DLL

Tokenbinding.dll

See also

TokenBindingVerifyMessage
HeapAlloc
HeapFree

 

 

Show: