ホーム › Devices.BiometricFramework › WinBioEnumServiceProviders
WinBioEnumServiceProviders
関数指定した生体認証要素のサービスプロバイダ一覧を列挙する。
シグネチャ
// winbio.dll
#include <windows.h>
HRESULT WinBioEnumServiceProviders(
DWORD Factor,
WINBIO_BSP_SCHEMA** BspSchemaArray,
UINT_PTR* BspCount
);パラメーター
| 名前 | 型 | 方向 | 説明 |
|---|---|---|---|
| Factor | DWORD | in | 列挙対象の生体認証ファクター(指紋/顔等)を表すフラグ。WINBIO_TYPE値の組み合わせ。 |
| BspSchemaArray | WINBIO_BSP_SCHEMA** | out | サービスプロバイダー情報の配列を受け取る出力ポインタ。要WinBioFreeで解放。 |
| BspCount | UINT_PTR* | out | 返された配列の要素数を受け取る出力ポインタ。 |
戻り値の型: HRESULT
各言語での呼び出し定義
// winbio.dll
#include <windows.h>
HRESULT WinBioEnumServiceProviders(
DWORD Factor,
WINBIO_BSP_SCHEMA** BspSchemaArray,
UINT_PTR* BspCount
);[DllImport("winbio.dll", ExactSpelling = true)]
static extern int WinBioEnumServiceProviders(
uint Factor, // DWORD
IntPtr BspSchemaArray, // WINBIO_BSP_SCHEMA** out
out UIntPtr BspCount // UINT_PTR* out
);<DllImport("winbio.dll", ExactSpelling:=True)>
Public Shared Function WinBioEnumServiceProviders(
Factor As UInteger, ' DWORD
BspSchemaArray As IntPtr, ' WINBIO_BSP_SCHEMA** out
<Out> ByRef BspCount As UIntPtr ' UINT_PTR* out
) As Integer
End Function' Factor : DWORD
' BspSchemaArray : WINBIO_BSP_SCHEMA** out
' BspCount : UINT_PTR* out
Declare PtrSafe Function WinBioEnumServiceProviders Lib "winbio" ( _
ByVal Factor As Long, _
ByVal BspSchemaArray As LongPtr, _
ByRef BspCount As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
WinBioEnumServiceProviders = ctypes.windll.winbio.WinBioEnumServiceProviders
WinBioEnumServiceProviders.restype = ctypes.c_int
WinBioEnumServiceProviders.argtypes = [
wintypes.DWORD, # Factor : DWORD
ctypes.c_void_p, # BspSchemaArray : WINBIO_BSP_SCHEMA** out
ctypes.POINTER(ctypes.c_size_t), # BspCount : UINT_PTR* out
]require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('winbio.dll')
WinBioEnumServiceProviders = Fiddle::Function.new(
lib['WinBioEnumServiceProviders'],
[
-Fiddle::TYPE_INT, # Factor : DWORD
Fiddle::TYPE_VOIDP, # BspSchemaArray : WINBIO_BSP_SCHEMA** out
Fiddle::TYPE_VOIDP, # BspCount : UINT_PTR* out
],
Fiddle::TYPE_INT)#[link(name = "winbio")]
extern "system" {
fn WinBioEnumServiceProviders(
Factor: u32, // DWORD
BspSchemaArray: *mut *mut WINBIO_BSP_SCHEMA, // WINBIO_BSP_SCHEMA** out
BspCount: *mut usize // UINT_PTR* out
) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[DllImport("winbio.dll")]
public static extern int WinBioEnumServiceProviders(uint Factor, IntPtr BspSchemaArray, out UIntPtr BspCount);
"@
$api = Add-Type -MemberDefinition $sig -Name 'winbio_WinBioEnumServiceProviders' -Namespace Win32 -PassThru
# $api::WinBioEnumServiceProviders(Factor, BspSchemaArray, BspCount)#uselib "winbio.dll"
#func global WinBioEnumServiceProviders "WinBioEnumServiceProviders" sptr, sptr, sptr
; WinBioEnumServiceProviders Factor, varptr(BspSchemaArray), varptr(BspCount) ; 戻り値は stat
; Factor : DWORD -> "sptr"
; BspSchemaArray : WINBIO_BSP_SCHEMA** out -> "sptr"
; BspCount : UINT_PTR* out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。出力引数:
#uselib "winbio.dll" #cfunc global WinBioEnumServiceProviders "WinBioEnumServiceProviders" int, var, var ; res = WinBioEnumServiceProviders(Factor, BspSchemaArray, BspCount) ; Factor : DWORD -> "int" ; BspSchemaArray : WINBIO_BSP_SCHEMA** out -> "var" ; BspCount : UINT_PTR* out -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "winbio.dll" #cfunc global WinBioEnumServiceProviders "WinBioEnumServiceProviders" int, sptr, sptr ; res = WinBioEnumServiceProviders(Factor, varptr(BspSchemaArray), varptr(BspCount)) ; Factor : DWORD -> "int" ; BspSchemaArray : WINBIO_BSP_SCHEMA** out -> "sptr" ; BspCount : UINT_PTR* out -> "sptr" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
出力引数:
; HRESULT WinBioEnumServiceProviders(DWORD Factor, WINBIO_BSP_SCHEMA** BspSchemaArray, UINT_PTR* BspCount) #uselib "winbio.dll" #cfunc global WinBioEnumServiceProviders "WinBioEnumServiceProviders" int, var, var ; res = WinBioEnumServiceProviders(Factor, BspSchemaArray, BspCount) ; Factor : DWORD -> "int" ; BspSchemaArray : WINBIO_BSP_SCHEMA** out -> "var" ; BspCount : UINT_PTR* out -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; HRESULT WinBioEnumServiceProviders(DWORD Factor, WINBIO_BSP_SCHEMA** BspSchemaArray, UINT_PTR* BspCount) #uselib "winbio.dll" #cfunc global WinBioEnumServiceProviders "WinBioEnumServiceProviders" int, intptr, intptr ; res = WinBioEnumServiceProviders(Factor, varptr(BspSchemaArray), varptr(BspCount)) ; Factor : DWORD -> "int" ; BspSchemaArray : WINBIO_BSP_SCHEMA** out -> "intptr" ; BspCount : UINT_PTR* out -> "intptr" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
winbio = windows.NewLazySystemDLL("winbio.dll")
procWinBioEnumServiceProviders = winbio.NewProc("WinBioEnumServiceProviders")
)
// Factor (DWORD), BspSchemaArray (WINBIO_BSP_SCHEMA** out), BspCount (UINT_PTR* out)
r1, _, err := procWinBioEnumServiceProviders.Call(
uintptr(Factor),
uintptr(BspSchemaArray),
uintptr(BspCount),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // HRESULTfunction WinBioEnumServiceProviders(
Factor: DWORD; // DWORD
BspSchemaArray: Pointer; // WINBIO_BSP_SCHEMA** out
BspCount: Pointer // UINT_PTR* out
): Integer; stdcall;
external 'winbio.dll' name 'WinBioEnumServiceProviders';result := DllCall("winbio\WinBioEnumServiceProviders"
, "UInt", Factor ; DWORD
, "Ptr", BspSchemaArray ; WINBIO_BSP_SCHEMA** out
, "Ptr", BspCount ; UINT_PTR* out
, "Int") ; return: HRESULT●WinBioEnumServiceProviders(Factor, BspSchemaArray, BspCount) = DLL("winbio.dll", "int WinBioEnumServiceProviders(dword, void*, void*)")
# 呼び出し: WinBioEnumServiceProviders(Factor, BspSchemaArray, BspCount)
# Factor : DWORD -> "dword"
# BspSchemaArray : WINBIO_BSP_SCHEMA** out -> "void*"
# BspCount : UINT_PTR* out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。const std = @import("std");
extern "winbio" fn WinBioEnumServiceProviders(
Factor: u32, // DWORD
BspSchemaArray: [*c][*c]WINBIO_BSP_SCHEMA, // WINBIO_BSP_SCHEMA** out
BspCount: [*c]usize // UINT_PTR* out
) callconv(std.os.windows.WINAPI) i32;proc WinBioEnumServiceProviders(
Factor: uint32, # DWORD
BspSchemaArray: ptr WINBIO_BSP_SCHEMA, # WINBIO_BSP_SCHEMA** out
BspCount: ptr uint # UINT_PTR* out
): int32 {.importc: "WinBioEnumServiceProviders", stdcall, dynlib: "winbio.dll".}pragma(lib, "winbio");
extern(Windows)
int WinBioEnumServiceProviders(
uint Factor, // DWORD
WINBIO_BSP_SCHEMA** BspSchemaArray, // WINBIO_BSP_SCHEMA** out
size_t* BspCount // UINT_PTR* out
);ccall((:WinBioEnumServiceProviders, "winbio.dll"), stdcall, Int32,
(UInt32, Ptr{WINBIO_BSP_SCHEMA}, Ptr{Csize_t}),
Factor, BspSchemaArray, BspCount)
# Factor : DWORD -> UInt32
# BspSchemaArray : WINBIO_BSP_SCHEMA** out -> Ptr{WINBIO_BSP_SCHEMA}
# BspCount : UINT_PTR* out -> Ptr{Csize_t}
# stdcall は 32bit のみ意味を持つ(x64 では無視)。local ffi = require("ffi")
ffi.cdef[[
int32_t WinBioEnumServiceProviders(
uint32_t Factor,
void* BspSchemaArray,
uintptr_t* BspCount);
]]
local winbio = ffi.load("winbio")
-- winbio.WinBioEnumServiceProviders(Factor, BspSchemaArray, BspCount)
-- Factor : DWORD
-- BspSchemaArray : WINBIO_BSP_SCHEMA** out
-- BspCount : UINT_PTR* out
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。const koffi = require('koffi');
const lib = koffi.load('winbio.dll');
const WinBioEnumServiceProviders = lib.func('__stdcall', 'WinBioEnumServiceProviders', 'int32_t', ['uint32_t', 'void *', 'uintptr_t *']);
// WinBioEnumServiceProviders(Factor, BspSchemaArray, BspCount)
// Factor : DWORD -> 'uint32_t'
// BspSchemaArray : WINBIO_BSP_SCHEMA** out -> 'void *'
// BspCount : UINT_PTR* out -> 'uintptr_t *'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。const lib = Deno.dlopen("winbio.dll", {
WinBioEnumServiceProviders: { parameters: ["u32", "pointer", "pointer"], result: "i32" },
});
// lib.symbols.WinBioEnumServiceProviders(Factor, BspSchemaArray, BspCount)
// Factor : DWORD -> "u32"
// BspSchemaArray : WINBIO_BSP_SCHEMA** out -> "pointer"
// BspCount : UINT_PTR* out -> "pointer"
// 文字列引数は "buffer"(NUL 終端のバイト列を Uint8Array で渡す)。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。<?php
$ffi = FFI::cdef(<<<C
int32_t WinBioEnumServiceProviders(
uint32_t Factor,
void* BspSchemaArray,
size_t* BspCount);
C, "winbio.dll");
// $ffi->WinBioEnumServiceProviders(Factor, BspSchemaArray, BspCount);
// Factor : DWORD
// BspSchemaArray : WINBIO_BSP_SCHEMA** out
// BspCount : UINT_PTR* 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 Winbio extends StdCallLibrary {
Winbio INSTANCE = Native.load("winbio", Winbio.class);
int WinBioEnumServiceProviders(
int Factor, // DWORD
Pointer BspSchemaArray, // WINBIO_BSP_SCHEMA** out
LongByReference BspCount // UINT_PTR* out
);
}@[Link("winbio")]
lib Libwinbio
fun WinBioEnumServiceProviders = WinBioEnumServiceProviders(
Factor : UInt32, # DWORD
BspSchemaArray : WINBIO_BSP_SCHEMA**, # WINBIO_BSP_SCHEMA** out
BspCount : LibC::SizeT* # UINT_PTR* out
) : Int32
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。import 'dart:ffi';
import 'package:ffi/ffi.dart';
typedef WinBioEnumServiceProvidersNative = Int32 Function(Uint32, Pointer<Void>, Pointer<UintPtr>);
typedef WinBioEnumServiceProvidersDart = int Function(int, Pointer<Void>, Pointer<UintPtr>);
final WinBioEnumServiceProviders = DynamicLibrary.open('winbio.dll')
.lookupFunction<WinBioEnumServiceProvidersNative, WinBioEnumServiceProvidersDart>('WinBioEnumServiceProviders');
// Factor : DWORD -> Uint32
// BspSchemaArray : WINBIO_BSP_SCHEMA** out -> Pointer<Void>
// BspCount : UINT_PTR* out -> Pointer<UintPtr>
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。{$mode objfpc}{$H+}
function WinBioEnumServiceProviders(
Factor: DWORD; // DWORD
BspSchemaArray: Pointer; // WINBIO_BSP_SCHEMA** out
BspCount: Pointer // UINT_PTR* out
): Integer; stdcall;
external 'winbio.dll' name 'WinBioEnumServiceProviders';import Foreign
import Foreign.C.Types
import Foreign.C.String
foreign import stdcall safe "WinBioEnumServiceProviders"
c_WinBioEnumServiceProviders :: Word32 -> Ptr () -> Ptr CUIntPtr -> IO Int32
-- Factor : DWORD -> Word32
-- BspSchemaArray : WINBIO_BSP_SCHEMA** out -> Ptr ()
-- BspCount : UINT_PTR* out -> Ptr CUIntPtr
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。open Ctypes
open Foreign
let winbioenumserviceproviders =
foreign "WinBioEnumServiceProviders"
(uint32_t @-> (ptr void) @-> (ptr size_t) @-> returning int32_t)
(* Factor : DWORD -> uint32_t *)
(* BspSchemaArray : WINBIO_BSP_SCHEMA** out -> (ptr void) *)
(* BspCount : UINT_PTR* out -> (ptr size_t) *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)(cffi:define-foreign-library winbio (t "winbio.dll"))
(cffi:use-foreign-library winbio)
(cffi:defcfun ("WinBioEnumServiceProviders" win-bio-enum-service-providers :convention :stdcall) :int32
(factor :uint32) ; DWORD
(bsp-schema-array :pointer) ; WINBIO_BSP_SCHEMA** out
(bsp-count :pointer)) ; UINT_PTR* out
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。use Win32::API;
my $WinBioEnumServiceProviders = Win32::API::More->new('winbio',
'int WinBioEnumServiceProviders(DWORD Factor, LPVOID BspSchemaArray, LPVOID BspCount)');
# my $ret = $WinBioEnumServiceProviders->Call($Factor, $BspSchemaArray, $BspCount);
# Factor : DWORD -> DWORD
# BspSchemaArray : WINBIO_BSP_SCHEMA** out -> LPVOID
# BspCount : UINT_PTR* out -> LPVOID
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。関連項目
使用する型