ホーム › Security.Authentication.WebAuthn › WebAuthNAuthenticatorMakeCredential

WebAuthNAuthenticatorMakeCredential

関数

認証器を用いて新しいWebAuthn資格情報を作成する。

DLLwebauthn.dll呼出規約winapi

シグネチャ

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

HRESULT WebAuthNAuthenticatorMakeCredential(
    HWND hWnd,
    WEBAUTHN_RP_ENTITY_INFORMATION* pRpInformation,
    WEBAUTHN_USER_ENTITY_INFORMATION* pUserInformation,
    WEBAUTHN_COSE_CREDENTIAL_PARAMETERS* pPubKeyCredParams,
    WEBAUTHN_CLIENT_DATA* pWebAuthNClientData,
    WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* pWebAuthNMakeCredentialOptions,   // optional
    WEBAUTHN_CREDENTIAL_ATTESTATION** ppWebAuthNCredentialAttestation
);

パラメーター

名前	型	方向	説明
hWnd	HWND	in	UIを表示する親ウィンドウのハンドル。フォアグラウンドで操作するウィンドウを指定する。
pRpInformation	WEBAUTHN_RP_ENTITY_INFORMATION*	in	依拠当事者(RP)情報を保持するWEBAUTHN_RP_ENTITY_INFORMATION構造体へのポインタ。
pUserInformation	WEBAUTHN_USER_ENTITY_INFORMATION*	in	ユーザーエンティティ情報を保持するWEBAUTHN_USER_ENTITY_INFORMATION構造体へのポインタ。
pPubKeyCredParams	WEBAUTHN_COSE_CREDENTIAL_PARAMETERS*	in	許可する公開鍵資格情報パラメータの一覧WEBAUTHN_COSE_CREDENTIAL_PARAMETERSへのポインタ。
pWebAuthNClientData	WEBAUTHN_CLIENT_DATA*	in	クライアントデータ(チャレンジ等)を保持するWEBAUTHN_CLIENT_DATA構造体へのポインタ。
pWebAuthNMakeCredentialOptions	WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS*	inoptional	資格情報作成オプションを保持する構造体へのポインタ。NULL可。
ppWebAuthNCredentialAttestation	WEBAUTHN_CREDENTIAL_ATTESTATION**	out	作成された資格情報のアテステーション結果を受け取るポインタ。WebAuthNFreeCredentialAttestationで解放する。

戻り値の型: HRESULT

各言語での呼び出し定義

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

HRESULT WebAuthNAuthenticatorMakeCredential(
    HWND hWnd,
    WEBAUTHN_RP_ENTITY_INFORMATION* pRpInformation,
    WEBAUTHN_USER_ENTITY_INFORMATION* pUserInformation,
    WEBAUTHN_COSE_CREDENTIAL_PARAMETERS* pPubKeyCredParams,
    WEBAUTHN_CLIENT_DATA* pWebAuthNClientData,
    WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* pWebAuthNMakeCredentialOptions,   // optional
    WEBAUTHN_CREDENTIAL_ATTESTATION** ppWebAuthNCredentialAttestation
);

[DllImport("webauthn.dll", ExactSpelling = true)]
static extern int WebAuthNAuthenticatorMakeCredential(
    IntPtr hWnd,   // HWND
    IntPtr pRpInformation,   // WEBAUTHN_RP_ENTITY_INFORMATION*
    IntPtr pUserInformation,   // WEBAUTHN_USER_ENTITY_INFORMATION*
    IntPtr pPubKeyCredParams,   // WEBAUTHN_COSE_CREDENTIAL_PARAMETERS*
    IntPtr pWebAuthNClientData,   // WEBAUTHN_CLIENT_DATA*
    IntPtr pWebAuthNMakeCredentialOptions,   // WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional
    IntPtr ppWebAuthNCredentialAttestation   // WEBAUTHN_CREDENTIAL_ATTESTATION** out
);

<DllImport("webauthn.dll", ExactSpelling:=True)>
Public Shared Function WebAuthNAuthenticatorMakeCredential(
    hWnd As IntPtr,   ' HWND
    pRpInformation As IntPtr,   ' WEBAUTHN_RP_ENTITY_INFORMATION*
    pUserInformation As IntPtr,   ' WEBAUTHN_USER_ENTITY_INFORMATION*
    pPubKeyCredParams As IntPtr,   ' WEBAUTHN_COSE_CREDENTIAL_PARAMETERS*
    pWebAuthNClientData As IntPtr,   ' WEBAUTHN_CLIENT_DATA*
    pWebAuthNMakeCredentialOptions As IntPtr,   ' WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional
    ppWebAuthNCredentialAttestation As IntPtr   ' WEBAUTHN_CREDENTIAL_ATTESTATION** out
) As Integer
End Function

' hWnd : HWND
' pRpInformation : WEBAUTHN_RP_ENTITY_INFORMATION*
' pUserInformation : WEBAUTHN_USER_ENTITY_INFORMATION*
' pPubKeyCredParams : WEBAUTHN_COSE_CREDENTIAL_PARAMETERS*
' pWebAuthNClientData : WEBAUTHN_CLIENT_DATA*
' pWebAuthNMakeCredentialOptions : WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional
' ppWebAuthNCredentialAttestation : WEBAUTHN_CREDENTIAL_ATTESTATION** out
Declare PtrSafe Function WebAuthNAuthenticatorMakeCredential Lib "webauthn" ( _
    ByVal hWnd As LongPtr, _
    ByVal pRpInformation As LongPtr, _
    ByVal pUserInformation As LongPtr, _
    ByVal pPubKeyCredParams As LongPtr, _
    ByVal pWebAuthNClientData As LongPtr, _
    ByVal pWebAuthNMakeCredentialOptions As LongPtr, _
    ByVal ppWebAuthNCredentialAttestation As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

WebAuthNAuthenticatorMakeCredential = ctypes.windll.webauthn.WebAuthNAuthenticatorMakeCredential
WebAuthNAuthenticatorMakeCredential.restype = ctypes.c_int
WebAuthNAuthenticatorMakeCredential.argtypes = [
    wintypes.HANDLE,  # hWnd : HWND
    ctypes.c_void_p,  # pRpInformation : WEBAUTHN_RP_ENTITY_INFORMATION*
    ctypes.c_void_p,  # pUserInformation : WEBAUTHN_USER_ENTITY_INFORMATION*
    ctypes.c_void_p,  # pPubKeyCredParams : WEBAUTHN_COSE_CREDENTIAL_PARAMETERS*
    ctypes.c_void_p,  # pWebAuthNClientData : WEBAUTHN_CLIENT_DATA*
    ctypes.c_void_p,  # pWebAuthNMakeCredentialOptions : WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional
    ctypes.c_void_p,  # ppWebAuthNCredentialAttestation : WEBAUTHN_CREDENTIAL_ATTESTATION** out
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('webauthn.dll')
WebAuthNAuthenticatorMakeCredential = Fiddle::Function.new(
  lib['WebAuthNAuthenticatorMakeCredential'],
  [
    Fiddle::TYPE_VOIDP,  # hWnd : HWND
    Fiddle::TYPE_VOIDP,  # pRpInformation : WEBAUTHN_RP_ENTITY_INFORMATION*
    Fiddle::TYPE_VOIDP,  # pUserInformation : WEBAUTHN_USER_ENTITY_INFORMATION*
    Fiddle::TYPE_VOIDP,  # pPubKeyCredParams : WEBAUTHN_COSE_CREDENTIAL_PARAMETERS*
    Fiddle::TYPE_VOIDP,  # pWebAuthNClientData : WEBAUTHN_CLIENT_DATA*
    Fiddle::TYPE_VOIDP,  # pWebAuthNMakeCredentialOptions : WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional
    Fiddle::TYPE_VOIDP,  # ppWebAuthNCredentialAttestation : WEBAUTHN_CREDENTIAL_ATTESTATION** out
  ],
  Fiddle::TYPE_INT)

#[link(name = "webauthn")]
extern "system" {
    fn WebAuthNAuthenticatorMakeCredential(
        hWnd: *mut core::ffi::c_void,  // HWND
        pRpInformation: *mut WEBAUTHN_RP_ENTITY_INFORMATION,  // WEBAUTHN_RP_ENTITY_INFORMATION*
        pUserInformation: *mut WEBAUTHN_USER_ENTITY_INFORMATION,  // WEBAUTHN_USER_ENTITY_INFORMATION*
        pPubKeyCredParams: *mut WEBAUTHN_COSE_CREDENTIAL_PARAMETERS,  // WEBAUTHN_COSE_CREDENTIAL_PARAMETERS*
        pWebAuthNClientData: *mut WEBAUTHN_CLIENT_DATA,  // WEBAUTHN_CLIENT_DATA*
        pWebAuthNMakeCredentialOptions: *mut WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS,  // WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional
        ppWebAuthNCredentialAttestation: *mut *mut WEBAUTHN_CREDENTIAL_ATTESTATION  // WEBAUTHN_CREDENTIAL_ATTESTATION** out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("webauthn.dll")]
public static extern int WebAuthNAuthenticatorMakeCredential(IntPtr hWnd, IntPtr pRpInformation, IntPtr pUserInformation, IntPtr pPubKeyCredParams, IntPtr pWebAuthNClientData, IntPtr pWebAuthNMakeCredentialOptions, IntPtr ppWebAuthNCredentialAttestation);
"@
$api = Add-Type -MemberDefinition $sig -Name 'webauthn_WebAuthNAuthenticatorMakeCredential' -Namespace Win32 -PassThru
# $api::WebAuthNAuthenticatorMakeCredential(hWnd, pRpInformation, pUserInformation, pPubKeyCredParams, pWebAuthNClientData, pWebAuthNMakeCredentialOptions, ppWebAuthNCredentialAttestation)

#uselib "webauthn.dll"
#func global WebAuthNAuthenticatorMakeCredential "WebAuthNAuthenticatorMakeCredential" sptr, sptr, sptr, sptr, sptr, sptr, sptr
; WebAuthNAuthenticatorMakeCredential hWnd, varptr(pRpInformation), varptr(pUserInformation), varptr(pPubKeyCredParams), varptr(pWebAuthNClientData), varptr(pWebAuthNMakeCredentialOptions), varptr(ppWebAuthNCredentialAttestation)   ; 戻り値は stat
; hWnd : HWND -> "sptr"
; pRpInformation : WEBAUTHN_RP_ENTITY_INFORMATION* -> "sptr"
; pUserInformation : WEBAUTHN_USER_ENTITY_INFORMATION* -> "sptr"
; pPubKeyCredParams : WEBAUTHN_COSE_CREDENTIAL_PARAMETERS* -> "sptr"
; pWebAuthNClientData : WEBAUTHN_CLIENT_DATA* -> "sptr"
; pWebAuthNMakeCredentialOptions : WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional -> "sptr"
; ppWebAuthNCredentialAttestation : WEBAUTHN_CREDENTIAL_ATTESTATION** out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "webauthn.dll"
#cfunc global WebAuthNAuthenticatorMakeCredential "WebAuthNAuthenticatorMakeCredential" sptr, var, var, var, var, var, var
; res = WebAuthNAuthenticatorMakeCredential(hWnd, pRpInformation, pUserInformation, pPubKeyCredParams, pWebAuthNClientData, pWebAuthNMakeCredentialOptions, ppWebAuthNCredentialAttestation)
; hWnd : HWND -> "sptr"
; pRpInformation : WEBAUTHN_RP_ENTITY_INFORMATION* -> "var"
; pUserInformation : WEBAUTHN_USER_ENTITY_INFORMATION* -> "var"
; pPubKeyCredParams : WEBAUTHN_COSE_CREDENTIAL_PARAMETERS* -> "var"
; pWebAuthNClientData : WEBAUTHN_CLIENT_DATA* -> "var"
; pWebAuthNMakeCredentialOptions : WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional -> "var"
; ppWebAuthNCredentialAttestation : WEBAUTHN_CREDENTIAL_ATTESTATION** out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "webauthn.dll"
#cfunc global WebAuthNAuthenticatorMakeCredential "WebAuthNAuthenticatorMakeCredential" sptr, sptr, sptr, sptr, sptr, sptr, sptr
; res = WebAuthNAuthenticatorMakeCredential(hWnd, varptr(pRpInformation), varptr(pUserInformation), varptr(pPubKeyCredParams), varptr(pWebAuthNClientData), varptr(pWebAuthNMakeCredentialOptions), varptr(ppWebAuthNCredentialAttestation))
; hWnd : HWND -> "sptr"
; pRpInformation : WEBAUTHN_RP_ENTITY_INFORMATION* -> "sptr"
; pUserInformation : WEBAUTHN_USER_ENTITY_INFORMATION* -> "sptr"
; pPubKeyCredParams : WEBAUTHN_COSE_CREDENTIAL_PARAMETERS* -> "sptr"
; pWebAuthNClientData : WEBAUTHN_CLIENT_DATA* -> "sptr"
; pWebAuthNMakeCredentialOptions : WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional -> "sptr"
; ppWebAuthNCredentialAttestation : WEBAUTHN_CREDENTIAL_ATTESTATION** out -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。

出力引数:

; HRESULT WebAuthNAuthenticatorMakeCredential(HWND hWnd, WEBAUTHN_RP_ENTITY_INFORMATION* pRpInformation, WEBAUTHN_USER_ENTITY_INFORMATION* pUserInformation, WEBAUTHN_COSE_CREDENTIAL_PARAMETERS* pPubKeyCredParams, WEBAUTHN_CLIENT_DATA* pWebAuthNClientData, WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* pWebAuthNMakeCredentialOptions, WEBAUTHN_CREDENTIAL_ATTESTATION** ppWebAuthNCredentialAttestation)
#uselib "webauthn.dll"
#cfunc global WebAuthNAuthenticatorMakeCredential "WebAuthNAuthenticatorMakeCredential" intptr, var, var, var, var, var, var
; res = WebAuthNAuthenticatorMakeCredential(hWnd, pRpInformation, pUserInformation, pPubKeyCredParams, pWebAuthNClientData, pWebAuthNMakeCredentialOptions, ppWebAuthNCredentialAttestation)
; hWnd : HWND -> "intptr"
; pRpInformation : WEBAUTHN_RP_ENTITY_INFORMATION* -> "var"
; pUserInformation : WEBAUTHN_USER_ENTITY_INFORMATION* -> "var"
; pPubKeyCredParams : WEBAUTHN_COSE_CREDENTIAL_PARAMETERS* -> "var"
; pWebAuthNClientData : WEBAUTHN_CLIENT_DATA* -> "var"
; pWebAuthNMakeCredentialOptions : WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional -> "var"
; ppWebAuthNCredentialAttestation : WEBAUTHN_CREDENTIAL_ATTESTATION** out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; HRESULT WebAuthNAuthenticatorMakeCredential(HWND hWnd, WEBAUTHN_RP_ENTITY_INFORMATION* pRpInformation, WEBAUTHN_USER_ENTITY_INFORMATION* pUserInformation, WEBAUTHN_COSE_CREDENTIAL_PARAMETERS* pPubKeyCredParams, WEBAUTHN_CLIENT_DATA* pWebAuthNClientData, WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* pWebAuthNMakeCredentialOptions, WEBAUTHN_CREDENTIAL_ATTESTATION** ppWebAuthNCredentialAttestation)
#uselib "webauthn.dll"
#cfunc global WebAuthNAuthenticatorMakeCredential "WebAuthNAuthenticatorMakeCredential" intptr, intptr, intptr, intptr, intptr, intptr, intptr
; res = WebAuthNAuthenticatorMakeCredential(hWnd, varptr(pRpInformation), varptr(pUserInformation), varptr(pPubKeyCredParams), varptr(pWebAuthNClientData), varptr(pWebAuthNMakeCredentialOptions), varptr(ppWebAuthNCredentialAttestation))
; hWnd : HWND -> "intptr"
; pRpInformation : WEBAUTHN_RP_ENTITY_INFORMATION* -> "intptr"
; pUserInformation : WEBAUTHN_USER_ENTITY_INFORMATION* -> "intptr"
; pPubKeyCredParams : WEBAUTHN_COSE_CREDENTIAL_PARAMETERS* -> "intptr"
; pWebAuthNClientData : WEBAUTHN_CLIENT_DATA* -> "intptr"
; pWebAuthNMakeCredentialOptions : WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional -> "intptr"
; ppWebAuthNCredentialAttestation : WEBAUTHN_CREDENTIAL_ATTESTATION** out -> "intptr"
; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。

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

var (
	webauthn = windows.NewLazySystemDLL("webauthn.dll")
	procWebAuthNAuthenticatorMakeCredential = webauthn.NewProc("WebAuthNAuthenticatorMakeCredential")
)

// hWnd (HWND), pRpInformation (WEBAUTHN_RP_ENTITY_INFORMATION*), pUserInformation (WEBAUTHN_USER_ENTITY_INFORMATION*), pPubKeyCredParams (WEBAUTHN_COSE_CREDENTIAL_PARAMETERS*), pWebAuthNClientData (WEBAUTHN_CLIENT_DATA*), pWebAuthNMakeCredentialOptions (WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional), ppWebAuthNCredentialAttestation (WEBAUTHN_CREDENTIAL_ATTESTATION** out)
r1, _, err := procWebAuthNAuthenticatorMakeCredential.Call(
	uintptr(hWnd),
	uintptr(pRpInformation),
	uintptr(pUserInformation),
	uintptr(pPubKeyCredParams),
	uintptr(pWebAuthNClientData),
	uintptr(pWebAuthNMakeCredentialOptions),
	uintptr(ppWebAuthNCredentialAttestation),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // HRESULT

function WebAuthNAuthenticatorMakeCredential(
  hWnd: THandle;   // HWND
  pRpInformation: Pointer;   // WEBAUTHN_RP_ENTITY_INFORMATION*
  pUserInformation: Pointer;   // WEBAUTHN_USER_ENTITY_INFORMATION*
  pPubKeyCredParams: Pointer;   // WEBAUTHN_COSE_CREDENTIAL_PARAMETERS*
  pWebAuthNClientData: Pointer;   // WEBAUTHN_CLIENT_DATA*
  pWebAuthNMakeCredentialOptions: Pointer;   // WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional
  ppWebAuthNCredentialAttestation: Pointer   // WEBAUTHN_CREDENTIAL_ATTESTATION** out
): Integer; stdcall;
  external 'webauthn.dll' name 'WebAuthNAuthenticatorMakeCredential';

result := DllCall("webauthn\WebAuthNAuthenticatorMakeCredential"
    , "Ptr", hWnd   ; HWND
    , "Ptr", pRpInformation   ; WEBAUTHN_RP_ENTITY_INFORMATION*
    , "Ptr", pUserInformation   ; WEBAUTHN_USER_ENTITY_INFORMATION*
    , "Ptr", pPubKeyCredParams   ; WEBAUTHN_COSE_CREDENTIAL_PARAMETERS*
    , "Ptr", pWebAuthNClientData   ; WEBAUTHN_CLIENT_DATA*
    , "Ptr", pWebAuthNMakeCredentialOptions   ; WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional
    , "Ptr", ppWebAuthNCredentialAttestation   ; WEBAUTHN_CREDENTIAL_ATTESTATION** out
    , "Int")   ; return: HRESULT

●WebAuthNAuthenticatorMakeCredential(hWnd, pRpInformation, pUserInformation, pPubKeyCredParams, pWebAuthNClientData, pWebAuthNMakeCredentialOptions, ppWebAuthNCredentialAttestation) = DLL("webauthn.dll", "int WebAuthNAuthenticatorMakeCredential(void*, void*, void*, void*, void*, void*, void*)")
# 呼び出し: WebAuthNAuthenticatorMakeCredential(hWnd, pRpInformation, pUserInformation, pPubKeyCredParams, pWebAuthNClientData, pWebAuthNMakeCredentialOptions, ppWebAuthNCredentialAttestation)
# hWnd : HWND -> "void*"
# pRpInformation : WEBAUTHN_RP_ENTITY_INFORMATION* -> "void*"
# pUserInformation : WEBAUTHN_USER_ENTITY_INFORMATION* -> "void*"
# pPubKeyCredParams : WEBAUTHN_COSE_CREDENTIAL_PARAMETERS* -> "void*"
# pWebAuthNClientData : WEBAUTHN_CLIENT_DATA* -> "void*"
# pWebAuthNMakeCredentialOptions : WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional -> "void*"
# ppWebAuthNCredentialAttestation : WEBAUTHN_CREDENTIAL_ATTESTATION** out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。

const std = @import("std");

extern "webauthn" fn WebAuthNAuthenticatorMakeCredential(
    hWnd: ?*anyopaque, // HWND
    pRpInformation: [*c]WEBAUTHN_RP_ENTITY_INFORMATION, // WEBAUTHN_RP_ENTITY_INFORMATION*
    pUserInformation: [*c]WEBAUTHN_USER_ENTITY_INFORMATION, // WEBAUTHN_USER_ENTITY_INFORMATION*
    pPubKeyCredParams: [*c]WEBAUTHN_COSE_CREDENTIAL_PARAMETERS, // WEBAUTHN_COSE_CREDENTIAL_PARAMETERS*
    pWebAuthNClientData: [*c]WEBAUTHN_CLIENT_DATA, // WEBAUTHN_CLIENT_DATA*
    pWebAuthNMakeCredentialOptions: [*c]WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS, // WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional
    ppWebAuthNCredentialAttestation: [*c][*c]WEBAUTHN_CREDENTIAL_ATTESTATION // WEBAUTHN_CREDENTIAL_ATTESTATION** out
) callconv(std.os.windows.WINAPI) i32;

proc WebAuthNAuthenticatorMakeCredential(
    hWnd: pointer,  # HWND
    pRpInformation: ptr WEBAUTHN_RP_ENTITY_INFORMATION,  # WEBAUTHN_RP_ENTITY_INFORMATION*
    pUserInformation: ptr WEBAUTHN_USER_ENTITY_INFORMATION,  # WEBAUTHN_USER_ENTITY_INFORMATION*
    pPubKeyCredParams: ptr WEBAUTHN_COSE_CREDENTIAL_PARAMETERS,  # WEBAUTHN_COSE_CREDENTIAL_PARAMETERS*
    pWebAuthNClientData: ptr WEBAUTHN_CLIENT_DATA,  # WEBAUTHN_CLIENT_DATA*
    pWebAuthNMakeCredentialOptions: ptr WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS,  # WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional
    ppWebAuthNCredentialAttestation: ptr WEBAUTHN_CREDENTIAL_ATTESTATION  # WEBAUTHN_CREDENTIAL_ATTESTATION** out
): int32 {.importc: "WebAuthNAuthenticatorMakeCredential", stdcall, dynlib: "webauthn.dll".}

pragma(lib, "webauthn");
extern(Windows)
int WebAuthNAuthenticatorMakeCredential(
    void* hWnd,   // HWND
    WEBAUTHN_RP_ENTITY_INFORMATION* pRpInformation,   // WEBAUTHN_RP_ENTITY_INFORMATION*
    WEBAUTHN_USER_ENTITY_INFORMATION* pUserInformation,   // WEBAUTHN_USER_ENTITY_INFORMATION*
    WEBAUTHN_COSE_CREDENTIAL_PARAMETERS* pPubKeyCredParams,   // WEBAUTHN_COSE_CREDENTIAL_PARAMETERS*
    WEBAUTHN_CLIENT_DATA* pWebAuthNClientData,   // WEBAUTHN_CLIENT_DATA*
    WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* pWebAuthNMakeCredentialOptions,   // WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional
    WEBAUTHN_CREDENTIAL_ATTESTATION** ppWebAuthNCredentialAttestation   // WEBAUTHN_CREDENTIAL_ATTESTATION** out
);

ccall((:WebAuthNAuthenticatorMakeCredential, "webauthn.dll"), stdcall, Int32,
      (Ptr{Cvoid}, Ptr{WEBAUTHN_RP_ENTITY_INFORMATION}, Ptr{WEBAUTHN_USER_ENTITY_INFORMATION}, Ptr{WEBAUTHN_COSE_CREDENTIAL_PARAMETERS}, Ptr{WEBAUTHN_CLIENT_DATA}, Ptr{WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS}, Ptr{WEBAUTHN_CREDENTIAL_ATTESTATION}),
      hWnd, pRpInformation, pUserInformation, pPubKeyCredParams, pWebAuthNClientData, pWebAuthNMakeCredentialOptions, ppWebAuthNCredentialAttestation)
# hWnd : HWND -> Ptr{Cvoid}
# pRpInformation : WEBAUTHN_RP_ENTITY_INFORMATION* -> Ptr{WEBAUTHN_RP_ENTITY_INFORMATION}
# pUserInformation : WEBAUTHN_USER_ENTITY_INFORMATION* -> Ptr{WEBAUTHN_USER_ENTITY_INFORMATION}
# pPubKeyCredParams : WEBAUTHN_COSE_CREDENTIAL_PARAMETERS* -> Ptr{WEBAUTHN_COSE_CREDENTIAL_PARAMETERS}
# pWebAuthNClientData : WEBAUTHN_CLIENT_DATA* -> Ptr{WEBAUTHN_CLIENT_DATA}
# pWebAuthNMakeCredentialOptions : WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional -> Ptr{WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS}
# ppWebAuthNCredentialAttestation : WEBAUTHN_CREDENTIAL_ATTESTATION** out -> Ptr{WEBAUTHN_CREDENTIAL_ATTESTATION}
# stdcall は 32bit のみ意味を持つ(x64 では無視)。

local ffi = require("ffi")
ffi.cdef[[
int32_t WebAuthNAuthenticatorMakeCredential(
    void* hWnd,
    void* pRpInformation,
    void* pUserInformation,
    void* pPubKeyCredParams,
    void* pWebAuthNClientData,
    void* pWebAuthNMakeCredentialOptions,
    void* ppWebAuthNCredentialAttestation);
]]
local webauthn = ffi.load("webauthn")
-- webauthn.WebAuthNAuthenticatorMakeCredential(hWnd, pRpInformation, pUserInformation, pPubKeyCredParams, pWebAuthNClientData, pWebAuthNMakeCredentialOptions, ppWebAuthNCredentialAttestation)
-- hWnd : HWND
-- pRpInformation : WEBAUTHN_RP_ENTITY_INFORMATION*
-- pUserInformation : WEBAUTHN_USER_ENTITY_INFORMATION*
-- pPubKeyCredParams : WEBAUTHN_COSE_CREDENTIAL_PARAMETERS*
-- pWebAuthNClientData : WEBAUTHN_CLIENT_DATA*
-- pWebAuthNMakeCredentialOptions : WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional
-- ppWebAuthNCredentialAttestation : WEBAUTHN_CREDENTIAL_ATTESTATION** out
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。

const koffi = require('koffi');
const lib = koffi.load('webauthn.dll');
const WebAuthNAuthenticatorMakeCredential = lib.func('__stdcall', 'WebAuthNAuthenticatorMakeCredential', 'int32_t', ['void *', 'void *', 'void *', 'void *', 'void *', 'void *', 'void *']);
// WebAuthNAuthenticatorMakeCredential(hWnd, pRpInformation, pUserInformation, pPubKeyCredParams, pWebAuthNClientData, pWebAuthNMakeCredentialOptions, ppWebAuthNCredentialAttestation)
// hWnd : HWND -> 'void *'
// pRpInformation : WEBAUTHN_RP_ENTITY_INFORMATION* -> 'void *'
// pUserInformation : WEBAUTHN_USER_ENTITY_INFORMATION* -> 'void *'
// pPubKeyCredParams : WEBAUTHN_COSE_CREDENTIAL_PARAMETERS* -> 'void *'
// pWebAuthNClientData : WEBAUTHN_CLIENT_DATA* -> 'void *'
// pWebAuthNMakeCredentialOptions : WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional -> 'void *'
// ppWebAuthNCredentialAttestation : WEBAUTHN_CREDENTIAL_ATTESTATION** out -> 'void *'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。

const lib = Deno.dlopen("webauthn.dll", {
  WebAuthNAuthenticatorMakeCredential: { parameters: ["pointer", "pointer", "pointer", "pointer", "pointer", "pointer", "pointer"], result: "i32" },
});
// lib.symbols.WebAuthNAuthenticatorMakeCredential(hWnd, pRpInformation, pUserInformation, pPubKeyCredParams, pWebAuthNClientData, pWebAuthNMakeCredentialOptions, ppWebAuthNCredentialAttestation)
// hWnd : HWND -> "pointer"
// pRpInformation : WEBAUTHN_RP_ENTITY_INFORMATION* -> "pointer"
// pUserInformation : WEBAUTHN_USER_ENTITY_INFORMATION* -> "pointer"
// pPubKeyCredParams : WEBAUTHN_COSE_CREDENTIAL_PARAMETERS* -> "pointer"
// pWebAuthNClientData : WEBAUTHN_CLIENT_DATA* -> "pointer"
// pWebAuthNMakeCredentialOptions : WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional -> "pointer"
// ppWebAuthNCredentialAttestation : WEBAUTHN_CREDENTIAL_ATTESTATION** out -> "pointer"
// 文字列引数は "buffer"(NUL 終端のバイト列を Uint8Array で渡す)。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。

<?php
$ffi = FFI::cdef(<<<C
int32_t WebAuthNAuthenticatorMakeCredential(
    void* hWnd,
    void* pRpInformation,
    void* pUserInformation,
    void* pPubKeyCredParams,
    void* pWebAuthNClientData,
    void* pWebAuthNMakeCredentialOptions,
    void* ppWebAuthNCredentialAttestation);
C, "webauthn.dll");
// $ffi->WebAuthNAuthenticatorMakeCredential(hWnd, pRpInformation, pUserInformation, pPubKeyCredParams, pWebAuthNClientData, pWebAuthNMakeCredentialOptions, ppWebAuthNCredentialAttestation);
// hWnd : HWND
// pRpInformation : WEBAUTHN_RP_ENTITY_INFORMATION*
// pUserInformation : WEBAUTHN_USER_ENTITY_INFORMATION*
// pPubKeyCredParams : WEBAUTHN_COSE_CREDENTIAL_PARAMETERS*
// pWebAuthNClientData : WEBAUTHN_CLIENT_DATA*
// pWebAuthNMakeCredentialOptions : WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional
// ppWebAuthNCredentialAttestation : WEBAUTHN_CREDENTIAL_ATTESTATION** out
// 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
// WINAPI(stdcall): x64 では呼出規約が統一されるため問題なし。x86 では __stdcall 対応のラッパが必要な場合あり。

import com.sun.jna.*;
import com.sun.jna.ptr.*;
import com.sun.jna.win32.StdCallLibrary;
import com.sun.jna.win32.W32APIOptions;

public interface Webauthn extends StdCallLibrary {
    Webauthn INSTANCE = Native.load("webauthn", Webauthn.class);
    int WebAuthNAuthenticatorMakeCredential(
        Pointer hWnd,   // HWND
        Pointer pRpInformation,   // WEBAUTHN_RP_ENTITY_INFORMATION*
        Pointer pUserInformation,   // WEBAUTHN_USER_ENTITY_INFORMATION*
        Pointer pPubKeyCredParams,   // WEBAUTHN_COSE_CREDENTIAL_PARAMETERS*
        Pointer pWebAuthNClientData,   // WEBAUTHN_CLIENT_DATA*
        Pointer pWebAuthNMakeCredentialOptions,   // WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional
        Pointer ppWebAuthNCredentialAttestation   // WEBAUTHN_CREDENTIAL_ATTESTATION** out
    );
}

@[Link("webauthn")]
lib Libwebauthn
  fun WebAuthNAuthenticatorMakeCredential = WebAuthNAuthenticatorMakeCredential(
    hWnd : Void*,   # HWND
    pRpInformation : WEBAUTHN_RP_ENTITY_INFORMATION*,   # WEBAUTHN_RP_ENTITY_INFORMATION*
    pUserInformation : WEBAUTHN_USER_ENTITY_INFORMATION*,   # WEBAUTHN_USER_ENTITY_INFORMATION*
    pPubKeyCredParams : WEBAUTHN_COSE_CREDENTIAL_PARAMETERS*,   # WEBAUTHN_COSE_CREDENTIAL_PARAMETERS*
    pWebAuthNClientData : WEBAUTHN_CLIENT_DATA*,   # WEBAUTHN_CLIENT_DATA*
    pWebAuthNMakeCredentialOptions : WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS*,   # WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional
    ppWebAuthNCredentialAttestation : WEBAUTHN_CREDENTIAL_ATTESTATION**   # WEBAUTHN_CREDENTIAL_ATTESTATION** out
  ) : Int32
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。

import 'dart:ffi';
import 'package:ffi/ffi.dart';

typedef WebAuthNAuthenticatorMakeCredentialNative = Int32 Function(Pointer<Void>, Pointer<Void>, Pointer<Void>, Pointer<Void>, Pointer<Void>, Pointer<Void>, Pointer<Void>);
typedef WebAuthNAuthenticatorMakeCredentialDart = int Function(Pointer<Void>, Pointer<Void>, Pointer<Void>, Pointer<Void>, Pointer<Void>, Pointer<Void>, Pointer<Void>);
final WebAuthNAuthenticatorMakeCredential = DynamicLibrary.open('webauthn.dll')
    .lookupFunction<WebAuthNAuthenticatorMakeCredentialNative, WebAuthNAuthenticatorMakeCredentialDart>('WebAuthNAuthenticatorMakeCredential');
// hWnd : HWND -> Pointer<Void>
// pRpInformation : WEBAUTHN_RP_ENTITY_INFORMATION* -> Pointer<Void>
// pUserInformation : WEBAUTHN_USER_ENTITY_INFORMATION* -> Pointer<Void>
// pPubKeyCredParams : WEBAUTHN_COSE_CREDENTIAL_PARAMETERS* -> Pointer<Void>
// pWebAuthNClientData : WEBAUTHN_CLIENT_DATA* -> Pointer<Void>
// pWebAuthNMakeCredentialOptions : WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional -> Pointer<Void>
// ppWebAuthNCredentialAttestation : WEBAUTHN_CREDENTIAL_ATTESTATION** out -> Pointer<Void>
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。

{$mode objfpc}{$H+}
function WebAuthNAuthenticatorMakeCredential(
  hWnd: THandle;   // HWND
  pRpInformation: Pointer;   // WEBAUTHN_RP_ENTITY_INFORMATION*
  pUserInformation: Pointer;   // WEBAUTHN_USER_ENTITY_INFORMATION*
  pPubKeyCredParams: Pointer;   // WEBAUTHN_COSE_CREDENTIAL_PARAMETERS*
  pWebAuthNClientData: Pointer;   // WEBAUTHN_CLIENT_DATA*
  pWebAuthNMakeCredentialOptions: Pointer;   // WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional
  ppWebAuthNCredentialAttestation: Pointer   // WEBAUTHN_CREDENTIAL_ATTESTATION** out
): Integer; stdcall;
  external 'webauthn.dll' name 'WebAuthNAuthenticatorMakeCredential';

import Foreign
import Foreign.C.Types
import Foreign.C.String

foreign import stdcall safe "WebAuthNAuthenticatorMakeCredential"
  c_WebAuthNAuthenticatorMakeCredential :: Ptr () -> Ptr () -> Ptr () -> Ptr () -> Ptr () -> Ptr () -> Ptr () -> IO Int32
-- hWnd : HWND -> Ptr ()
-- pRpInformation : WEBAUTHN_RP_ENTITY_INFORMATION* -> Ptr ()
-- pUserInformation : WEBAUTHN_USER_ENTITY_INFORMATION* -> Ptr ()
-- pPubKeyCredParams : WEBAUTHN_COSE_CREDENTIAL_PARAMETERS* -> Ptr ()
-- pWebAuthNClientData : WEBAUTHN_CLIENT_DATA* -> Ptr ()
-- pWebAuthNMakeCredentialOptions : WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional -> Ptr ()
-- ppWebAuthNCredentialAttestation : WEBAUTHN_CREDENTIAL_ATTESTATION** out -> Ptr ()
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。

open Ctypes
open Foreign

let webauthnauthenticatormakecredential =
  foreign "WebAuthNAuthenticatorMakeCredential"
    ((ptr void) @-> (ptr void) @-> (ptr void) @-> (ptr void) @-> (ptr void) @-> (ptr void) @-> (ptr void) @-> returning int32_t)
(* hWnd : HWND -> (ptr void) *)
(* pRpInformation : WEBAUTHN_RP_ENTITY_INFORMATION* -> (ptr void) *)
(* pUserInformation : WEBAUTHN_USER_ENTITY_INFORMATION* -> (ptr void) *)
(* pPubKeyCredParams : WEBAUTHN_COSE_CREDENTIAL_PARAMETERS* -> (ptr void) *)
(* pWebAuthNClientData : WEBAUTHN_CLIENT_DATA* -> (ptr void) *)
(* pWebAuthNMakeCredentialOptions : WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional -> (ptr void) *)
(* ppWebAuthNCredentialAttestation : WEBAUTHN_CREDENTIAL_ATTESTATION** out -> (ptr void) *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)

(cffi:define-foreign-library webauthn (t "webauthn.dll"))
(cffi:use-foreign-library webauthn)

(cffi:defcfun ("WebAuthNAuthenticatorMakeCredential" web-auth-nauthenticator-make-credential :convention :stdcall) :int32
  (h-wnd :pointer)   ; HWND
  (p-rp-information :pointer)   ; WEBAUTHN_RP_ENTITY_INFORMATION*
  (p-user-information :pointer)   ; WEBAUTHN_USER_ENTITY_INFORMATION*
  (p-pub-key-cred-params :pointer)   ; WEBAUTHN_COSE_CREDENTIAL_PARAMETERS*
  (p-web-auth-nclient-data :pointer)   ; WEBAUTHN_CLIENT_DATA*
  (p-web-auth-nmake-credential-options :pointer)   ; WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional
  (pp-web-auth-ncredential-attestation :pointer))   ; WEBAUTHN_CREDENTIAL_ATTESTATION** out
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。

use Win32::API;
my $WebAuthNAuthenticatorMakeCredential = Win32::API::More->new('webauthn',
    'int WebAuthNAuthenticatorMakeCredential(HANDLE hWnd, LPVOID pRpInformation, LPVOID pUserInformation, LPVOID pPubKeyCredParams, LPVOID pWebAuthNClientData, LPVOID pWebAuthNMakeCredentialOptions, LPVOID ppWebAuthNCredentialAttestation)');
# my $ret = $WebAuthNAuthenticatorMakeCredential->Call($hWnd, $pRpInformation, $pUserInformation, $pPubKeyCredParams, $pWebAuthNClientData, $pWebAuthNMakeCredentialOptions, $ppWebAuthNCredentialAttestation);
# hWnd : HWND -> HANDLE
# pRpInformation : WEBAUTHN_RP_ENTITY_INFORMATION* -> LPVOID
# pUserInformation : WEBAUTHN_USER_ENTITY_INFORMATION* -> LPVOID
# pPubKeyCredParams : WEBAUTHN_COSE_CREDENTIAL_PARAMETERS* -> LPVOID
# pWebAuthNClientData : WEBAUTHN_CLIENT_DATA* -> LPVOID
# pWebAuthNMakeCredentialOptions : WEBAUTHN_AUTHENTICATOR_MAKE_CREDENTIAL_OPTIONS* optional -> LPVOID
# ppWebAuthNCredentialAttestation : WEBAUTHN_CREDENTIAL_ATTESTATION** out -> LPVOID
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。

WebAuthNAuthenticatorMakeCredential

シグネチャ

パラメーター

各言語での呼び出し定義

関連項目