TokenBindingGetKeyTypesServer function (tokenbinding.h)

Retrieves a list of the key types that the server supports.

Syntax

SECURITY_STATUS TokenBindingGetKeyTypesServer(
  [out] TOKENBINDING_KEY_TYPES **keyTypes
);

Parameters

[out] keyTypes

A pointer to a buffer that contains the list of key types that the server supports. TokenBindingGetKeyTypesServer returns the string identifiers for well-known algorithms that correspond to the keys that the server supports.

In user mode, use HeapAlloc to allocate the memory for the buffer, and HeapFree to free that memory. In kernel mode, use ExAllocatePoolWithTag to allocate the memory for the buffer, and ExFreePool to free that memory.

Return value

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

Remarks

You can call TokenBindingGetKeyTypesServer from both user mode and kernel mode. To call this function in kernel mode, link to Ksecdd.sys, and use the functions mentioned in the description for the keyTypes parameter for allocating and freeing memory.

Requirements

Requirement Value
Minimum supported client Windows 10 [desktop apps only]
Minimum supported server Windows Server 2016 [desktop apps only]
Target Platform Windows
Header tokenbinding.h
Library Tokenbinding.lib
DLL Tokenbinding.dll (user mode); Ksecdd.sys (kernel mode)

See also

HeapAlloc

HeapFree

TOKENBINDING_KEY_TYPES

TokenBindingGetKeyTypesClient

TokenBindingVerifyMessage