TokenBindingGetKeyTypesServer function

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

Syntax


SECURITY_STATUS WINAPI TokenBindingGetKeyTypesServer(
  _Out_ TOKENBINDING_KEY_TYPES **keyTypes
);

Parameters

keyTypes [out]

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

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 (user mode);
Ksecdd.sys (kernel mode)

See also

TokenBindingVerifyMessage
TokenBindingGetKeyTypesClient
TOKENBINDING_KEY_TYPES
HeapAlloc
HeapFree

 

 

Show: