ホーム › Security.Authentication.Identity › TokenBindingGenerateBinding

TokenBindingGenerateBinding

関数

トークンバインディング構造を生成しTLS鍵に紐付ける。

DLLTOKENBINDING.dll呼出規約winapi対応OSWindows 10 以降

シグネチャ

// TOKENBINDING.dll
#include <windows.h>

HRESULT TokenBindingGenerateBinding(
    TOKENBINDING_KEY_PARAMETERS_TYPE keyType,
    LPCWSTR targetURL,
    TOKENBINDING_TYPE bindingType,
    const void* tlsEKM,
    DWORD tlsEKMSize,
    TOKENBINDING_EXTENSION_FORMAT extensionFormat,
    const void* extensionData,
    void** tokenBinding,
    DWORD* tokenBindingSize,
    TOKENBINDING_RESULT_DATA** resultData   // optional
);

パラメーター

名前	型	方向
keyType	TOKENBINDING_KEY_PARAMETERS_TYPE	in
targetURL	LPCWSTR	in
bindingType	TOKENBINDING_TYPE	in
tlsEKM	void*	in
tlsEKMSize	DWORD	in
extensionFormat	TOKENBINDING_EXTENSION_FORMAT	in
extensionData	void*	in
tokenBinding	void**	out
tokenBindingSize	DWORD*	out
resultData	TOKENBINDING_RESULT_DATA**	outoptional

戻り値の型: HRESULT

各言語での呼び出し定義

// TOKENBINDING.dll
#include <windows.h>

HRESULT TokenBindingGenerateBinding(
    TOKENBINDING_KEY_PARAMETERS_TYPE keyType,
    LPCWSTR targetURL,
    TOKENBINDING_TYPE bindingType,
    const void* tlsEKM,
    DWORD tlsEKMSize,
    TOKENBINDING_EXTENSION_FORMAT extensionFormat,
    const void* extensionData,
    void** tokenBinding,
    DWORD* tokenBindingSize,
    TOKENBINDING_RESULT_DATA** resultData   // optional
);

[DllImport("TOKENBINDING.dll", ExactSpelling = true)]
static extern int TokenBindingGenerateBinding(
    int keyType,   // TOKENBINDING_KEY_PARAMETERS_TYPE
    [MarshalAs(UnmanagedType.LPWStr)] string targetURL,   // LPCWSTR
    int bindingType,   // TOKENBINDING_TYPE
    IntPtr tlsEKM,   // void*
    uint tlsEKMSize,   // DWORD
    int extensionFormat,   // TOKENBINDING_EXTENSION_FORMAT
    IntPtr extensionData,   // void*
    IntPtr tokenBinding,   // void** out
    out uint tokenBindingSize,   // DWORD* out
    IntPtr resultData   // TOKENBINDING_RESULT_DATA** optional, out
);

<DllImport("TOKENBINDING.dll", ExactSpelling:=True)>
Public Shared Function TokenBindingGenerateBinding(
    keyType As Integer,   ' TOKENBINDING_KEY_PARAMETERS_TYPE
    <MarshalAs(UnmanagedType.LPWStr)> targetURL As String,   ' LPCWSTR
    bindingType As Integer,   ' TOKENBINDING_TYPE
    tlsEKM As IntPtr,   ' void*
    tlsEKMSize As UInteger,   ' DWORD
    extensionFormat As Integer,   ' TOKENBINDING_EXTENSION_FORMAT
    extensionData As IntPtr,   ' void*
    tokenBinding As IntPtr,   ' void** out
    <Out> ByRef tokenBindingSize As UInteger,   ' DWORD* out
    resultData As IntPtr   ' TOKENBINDING_RESULT_DATA** optional, out
) As Integer
End Function

' keyType : TOKENBINDING_KEY_PARAMETERS_TYPE
' targetURL : LPCWSTR
' bindingType : TOKENBINDING_TYPE
' tlsEKM : void*
' tlsEKMSize : DWORD
' extensionFormat : TOKENBINDING_EXTENSION_FORMAT
' extensionData : void*
' tokenBinding : void** out
' tokenBindingSize : DWORD* out
' resultData : TOKENBINDING_RESULT_DATA** optional, out
Declare PtrSafe Function TokenBindingGenerateBinding Lib "tokenbinding" ( _
    ByVal keyType As Long, _
    ByVal targetURL As LongPtr, _
    ByVal bindingType As Long, _
    ByVal tlsEKM As LongPtr, _
    ByVal tlsEKMSize As Long, _
    ByVal extensionFormat As Long, _
    ByVal extensionData As LongPtr, _
    ByVal tokenBinding As LongPtr, _
    ByRef tokenBindingSize As Long, _
    ByVal resultData As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

TokenBindingGenerateBinding = ctypes.windll.tokenbinding.TokenBindingGenerateBinding
TokenBindingGenerateBinding.restype = ctypes.c_int
TokenBindingGenerateBinding.argtypes = [
    ctypes.c_int,  # keyType : TOKENBINDING_KEY_PARAMETERS_TYPE
    wintypes.LPCWSTR,  # targetURL : LPCWSTR
    ctypes.c_int,  # bindingType : TOKENBINDING_TYPE
    ctypes.POINTER(None),  # tlsEKM : void*
    wintypes.DWORD,  # tlsEKMSize : DWORD
    ctypes.c_int,  # extensionFormat : TOKENBINDING_EXTENSION_FORMAT
    ctypes.POINTER(None),  # extensionData : void*
    ctypes.c_void_p,  # tokenBinding : void** out
    ctypes.POINTER(wintypes.DWORD),  # tokenBindingSize : DWORD* out
    ctypes.c_void_p,  # resultData : TOKENBINDING_RESULT_DATA** optional, out
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('TOKENBINDING.dll')
TokenBindingGenerateBinding = Fiddle::Function.new(
  lib['TokenBindingGenerateBinding'],
  [
    Fiddle::TYPE_INT,  # keyType : TOKENBINDING_KEY_PARAMETERS_TYPE
    Fiddle::TYPE_VOIDP,  # targetURL : LPCWSTR
    Fiddle::TYPE_INT,  # bindingType : TOKENBINDING_TYPE
    Fiddle::TYPE_VOIDP,  # tlsEKM : void*
    -Fiddle::TYPE_INT,  # tlsEKMSize : DWORD
    Fiddle::TYPE_INT,  # extensionFormat : TOKENBINDING_EXTENSION_FORMAT
    Fiddle::TYPE_VOIDP,  # extensionData : void*
    Fiddle::TYPE_VOIDP,  # tokenBinding : void** out
    Fiddle::TYPE_VOIDP,  # tokenBindingSize : DWORD* out
    Fiddle::TYPE_VOIDP,  # resultData : TOKENBINDING_RESULT_DATA** optional, out
  ],
  Fiddle::TYPE_INT)

#[link(name = "tokenbinding")]
extern "system" {
    fn TokenBindingGenerateBinding(
        keyType: i32,  // TOKENBINDING_KEY_PARAMETERS_TYPE
        targetURL: *const u16,  // LPCWSTR
        bindingType: i32,  // TOKENBINDING_TYPE
        tlsEKM: *const (),  // void*
        tlsEKMSize: u32,  // DWORD
        extensionFormat: i32,  // TOKENBINDING_EXTENSION_FORMAT
        extensionData: *const (),  // void*
        tokenBinding: *mut *mut (),  // void** out
        tokenBindingSize: *mut u32,  // DWORD* out
        resultData: *mut *mut TOKENBINDING_RESULT_DATA  // TOKENBINDING_RESULT_DATA** optional, out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("TOKENBINDING.dll")]
public static extern int TokenBindingGenerateBinding(int keyType, [MarshalAs(UnmanagedType.LPWStr)] string targetURL, int bindingType, IntPtr tlsEKM, uint tlsEKMSize, int extensionFormat, IntPtr extensionData, IntPtr tokenBinding, out uint tokenBindingSize, IntPtr resultData);
"@
$api = Add-Type -MemberDefinition $sig -Name 'TOKENBINDING_TokenBindingGenerateBinding' -Namespace Win32 -PassThru
# $api::TokenBindingGenerateBinding(keyType, targetURL, bindingType, tlsEKM, tlsEKMSize, extensionFormat, extensionData, tokenBinding, tokenBindingSize, resultData)

#uselib "TOKENBINDING.dll"
#func global TokenBindingGenerateBinding "TokenBindingGenerateBinding" sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; TokenBindingGenerateBinding keyType, targetURL, bindingType, tlsEKM, tlsEKMSize, extensionFormat, extensionData, tokenBinding, varptr(tokenBindingSize), varptr(resultData)   ; 戻り値は stat
; keyType : TOKENBINDING_KEY_PARAMETERS_TYPE -> "sptr"
; targetURL : LPCWSTR -> "sptr"
; bindingType : TOKENBINDING_TYPE -> "sptr"
; tlsEKM : void* -> "sptr"
; tlsEKMSize : DWORD -> "sptr"
; extensionFormat : TOKENBINDING_EXTENSION_FORMAT -> "sptr"
; extensionData : void* -> "sptr"
; tokenBinding : void** out -> "sptr"
; tokenBindingSize : DWORD* out -> "sptr"
; resultData : TOKENBINDING_RESULT_DATA** optional, out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "TOKENBINDING.dll"
#cfunc global TokenBindingGenerateBinding "TokenBindingGenerateBinding" int, wstr, int, sptr, int, int, sptr, sptr, var, var
; res = TokenBindingGenerateBinding(keyType, targetURL, bindingType, tlsEKM, tlsEKMSize, extensionFormat, extensionData, tokenBinding, tokenBindingSize, resultData)
; keyType : TOKENBINDING_KEY_PARAMETERS_TYPE -> "int"
; targetURL : LPCWSTR -> "wstr"
; bindingType : TOKENBINDING_TYPE -> "int"
; tlsEKM : void* -> "sptr"
; tlsEKMSize : DWORD -> "int"
; extensionFormat : TOKENBINDING_EXTENSION_FORMAT -> "int"
; extensionData : void* -> "sptr"
; tokenBinding : void** out -> "sptr"
; tokenBindingSize : DWORD* out -> "var"
; resultData : TOKENBINDING_RESULT_DATA** optional, out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "TOKENBINDING.dll"
#cfunc global TokenBindingGenerateBinding "TokenBindingGenerateBinding" int, wstr, int, sptr, int, int, sptr, sptr, sptr, sptr
; res = TokenBindingGenerateBinding(keyType, targetURL, bindingType, tlsEKM, tlsEKMSize, extensionFormat, extensionData, tokenBinding, varptr(tokenBindingSize), varptr(resultData))
; keyType : TOKENBINDING_KEY_PARAMETERS_TYPE -> "int"
; targetURL : LPCWSTR -> "wstr"
; bindingType : TOKENBINDING_TYPE -> "int"
; tlsEKM : void* -> "sptr"
; tlsEKMSize : DWORD -> "int"
; extensionFormat : TOKENBINDING_EXTENSION_FORMAT -> "int"
; extensionData : void* -> "sptr"
; tokenBinding : void** out -> "sptr"
; tokenBindingSize : DWORD* out -> "sptr"
; resultData : TOKENBINDING_RESULT_DATA** optional, out -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。

出力引数:

; HRESULT TokenBindingGenerateBinding(TOKENBINDING_KEY_PARAMETERS_TYPE keyType, LPCWSTR targetURL, TOKENBINDING_TYPE bindingType, void* tlsEKM, DWORD tlsEKMSize, TOKENBINDING_EXTENSION_FORMAT extensionFormat, void* extensionData, void** tokenBinding, DWORD* tokenBindingSize, TOKENBINDING_RESULT_DATA** resultData)
#uselib "TOKENBINDING.dll"
#cfunc global TokenBindingGenerateBinding "TokenBindingGenerateBinding" int, wstr, int, intptr, int, int, intptr, intptr, var, var
; res = TokenBindingGenerateBinding(keyType, targetURL, bindingType, tlsEKM, tlsEKMSize, extensionFormat, extensionData, tokenBinding, tokenBindingSize, resultData)
; keyType : TOKENBINDING_KEY_PARAMETERS_TYPE -> "int"
; targetURL : LPCWSTR -> "wstr"
; bindingType : TOKENBINDING_TYPE -> "int"
; tlsEKM : void* -> "intptr"
; tlsEKMSize : DWORD -> "int"
; extensionFormat : TOKENBINDING_EXTENSION_FORMAT -> "int"
; extensionData : void* -> "intptr"
; tokenBinding : void** out -> "intptr"
; tokenBindingSize : DWORD* out -> "var"
; resultData : TOKENBINDING_RESULT_DATA** optional, out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; HRESULT TokenBindingGenerateBinding(TOKENBINDING_KEY_PARAMETERS_TYPE keyType, LPCWSTR targetURL, TOKENBINDING_TYPE bindingType, void* tlsEKM, DWORD tlsEKMSize, TOKENBINDING_EXTENSION_FORMAT extensionFormat, void* extensionData, void** tokenBinding, DWORD* tokenBindingSize, TOKENBINDING_RESULT_DATA** resultData)
#uselib "TOKENBINDING.dll"
#cfunc global TokenBindingGenerateBinding "TokenBindingGenerateBinding" int, wstr, int, intptr, int, int, intptr, intptr, intptr, intptr
; res = TokenBindingGenerateBinding(keyType, targetURL, bindingType, tlsEKM, tlsEKMSize, extensionFormat, extensionData, tokenBinding, varptr(tokenBindingSize), varptr(resultData))
; keyType : TOKENBINDING_KEY_PARAMETERS_TYPE -> "int"
; targetURL : LPCWSTR -> "wstr"
; bindingType : TOKENBINDING_TYPE -> "int"
; tlsEKM : void* -> "intptr"
; tlsEKMSize : DWORD -> "int"
; extensionFormat : TOKENBINDING_EXTENSION_FORMAT -> "int"
; extensionData : void* -> "intptr"
; tokenBinding : void** out -> "intptr"
; tokenBindingSize : DWORD* out -> "intptr"
; resultData : TOKENBINDING_RESULT_DATA** optional, out -> "intptr"
; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。

import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	tokenbinding = windows.NewLazySystemDLL("TOKENBINDING.dll")
	procTokenBindingGenerateBinding = tokenbinding.NewProc("TokenBindingGenerateBinding")
)

// keyType (TOKENBINDING_KEY_PARAMETERS_TYPE), targetURL (LPCWSTR), bindingType (TOKENBINDING_TYPE), tlsEKM (void*), tlsEKMSize (DWORD), extensionFormat (TOKENBINDING_EXTENSION_FORMAT), extensionData (void*), tokenBinding (void** out), tokenBindingSize (DWORD* out), resultData (TOKENBINDING_RESULT_DATA** optional, out)
r1, _, err := procTokenBindingGenerateBinding.Call(
	uintptr(keyType),
	uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(targetURL))),
	uintptr(bindingType),
	uintptr(tlsEKM),
	uintptr(tlsEKMSize),
	uintptr(extensionFormat),
	uintptr(extensionData),
	uintptr(tokenBinding),
	uintptr(tokenBindingSize),
	uintptr(resultData),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // HRESULT

function TokenBindingGenerateBinding(
  keyType: Integer;   // TOKENBINDING_KEY_PARAMETERS_TYPE
  targetURL: PWideChar;   // LPCWSTR
  bindingType: Integer;   // TOKENBINDING_TYPE
  tlsEKM: Pointer;   // void*
  tlsEKMSize: DWORD;   // DWORD
  extensionFormat: Integer;   // TOKENBINDING_EXTENSION_FORMAT
  extensionData: Pointer;   // void*
  tokenBinding: Pointer;   // void** out
  tokenBindingSize: Pointer;   // DWORD* out
  resultData: Pointer   // TOKENBINDING_RESULT_DATA** optional, out
): Integer; stdcall;
  external 'TOKENBINDING.dll' name 'TokenBindingGenerateBinding';

result := DllCall("TOKENBINDING\TokenBindingGenerateBinding"
    , "Int", keyType   ; TOKENBINDING_KEY_PARAMETERS_TYPE
    , "WStr", targetURL   ; LPCWSTR
    , "Int", bindingType   ; TOKENBINDING_TYPE
    , "Ptr", tlsEKM   ; void*
    , "UInt", tlsEKMSize   ; DWORD
    , "Int", extensionFormat   ; TOKENBINDING_EXTENSION_FORMAT
    , "Ptr", extensionData   ; void*
    , "Ptr", tokenBinding   ; void** out
    , "Ptr", tokenBindingSize   ; DWORD* out
    , "Ptr", resultData   ; TOKENBINDING_RESULT_DATA** optional, out
    , "Int")   ; return: HRESULT

●TokenBindingGenerateBinding(keyType, targetURL, bindingType, tlsEKM, tlsEKMSize, extensionFormat, extensionData, tokenBinding, tokenBindingSize, resultData) = DLL("TOKENBINDING.dll", "int TokenBindingGenerateBinding(int, char*, int, void*, dword, int, void*, void*, void*, void*)")
# 呼び出し: TokenBindingGenerateBinding(keyType, targetURL, bindingType, tlsEKM, tlsEKMSize, extensionFormat, extensionData, tokenBinding, tokenBindingSize, resultData)
# keyType : TOKENBINDING_KEY_PARAMETERS_TYPE -> "int"
# targetURL : LPCWSTR -> "char*"
# bindingType : TOKENBINDING_TYPE -> "int"
# tlsEKM : void* -> "void*"
# tlsEKMSize : DWORD -> "dword"
# extensionFormat : TOKENBINDING_EXTENSION_FORMAT -> "int"
# extensionData : void* -> "void*"
# tokenBinding : void** out -> "void*"
# tokenBindingSize : DWORD* out -> "void*"
# resultData : TOKENBINDING_RESULT_DATA** optional, out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。