ホーム › NetworkManagement.Rras › MprConfigTransportCreate
MprConfigTransportCreate
関数ルーター構成内に新しいトランスポートを作成する。
シグネチャ
// MPRAPI.dll
#include <windows.h>
DWORD MprConfigTransportCreate(
HANDLE hMprConfig,
DWORD dwTransportId,
LPWSTR lpwsTransportName, // optional
BYTE* pGlobalInfo,
DWORD dwGlobalInfoSize,
BYTE* pClientInterfaceInfo, // optional
DWORD dwClientInterfaceInfoSize, // optional
LPWSTR lpwsDLLPath, // optional
HANDLE* phRouterTransport
);パラメーター
| 名前 | 型 | 方向 | 説明 |
|---|---|---|---|
| hMprConfig | HANDLE | in | MprConfigServerConnectで取得した構成ハンドル。 |
| dwTransportId | DWORD | in | 作成するトランスポートの識別子(PID_IP等)。 |
| lpwsTransportName | LPWSTR | inoptional | トランスポートの表示名を指すUnicode文字列。 |
| pGlobalInfo | BYTE* | in | トランスポート全体のグローバル情報を格納したバッファへのポインタ。 |
| dwGlobalInfoSize | DWORD | in | pGlobalInfoが指すバッファのサイズ(バイト単位)。 |
| pClientInterfaceInfo | BYTE* | inoptional | 既定のクライアントインターフェイス情報を格納したバッファへのポインタ。不要ならNULL可。 |
| dwClientInterfaceInfoSize | DWORD | inoptional | pClientInterfaceInfoが指すバッファのサイズ(バイト単位)。 |
| lpwsDLLPath | LPWSTR | inoptional | このトランスポートを実装するDLLのパスを指すUnicode文字列。 |
| phRouterTransport | HANDLE* | out | 作成されたルータートランスポートのハンドルを受け取るポインタ。 |
戻り値の型: DWORD
各言語での呼び出し定義
// MPRAPI.dll
#include <windows.h>
DWORD MprConfigTransportCreate(
HANDLE hMprConfig,
DWORD dwTransportId,
LPWSTR lpwsTransportName, // optional
BYTE* pGlobalInfo,
DWORD dwGlobalInfoSize,
BYTE* pClientInterfaceInfo, // optional
DWORD dwClientInterfaceInfoSize, // optional
LPWSTR lpwsDLLPath, // optional
HANDLE* phRouterTransport
);[DllImport("MPRAPI.dll", ExactSpelling = true)]
static extern uint MprConfigTransportCreate(
IntPtr hMprConfig, // HANDLE
uint dwTransportId, // DWORD
[MarshalAs(UnmanagedType.LPWStr)] string lpwsTransportName, // LPWSTR optional
IntPtr pGlobalInfo, // BYTE*
uint dwGlobalInfoSize, // DWORD
IntPtr pClientInterfaceInfo, // BYTE* optional
uint dwClientInterfaceInfoSize, // DWORD optional
[MarshalAs(UnmanagedType.LPWStr)] string lpwsDLLPath, // LPWSTR optional
IntPtr phRouterTransport // HANDLE* out
);<DllImport("MPRAPI.dll", ExactSpelling:=True)>
Public Shared Function MprConfigTransportCreate(
hMprConfig As IntPtr, ' HANDLE
dwTransportId As UInteger, ' DWORD
<MarshalAs(UnmanagedType.LPWStr)> lpwsTransportName As String, ' LPWSTR optional
pGlobalInfo As IntPtr, ' BYTE*
dwGlobalInfoSize As UInteger, ' DWORD
pClientInterfaceInfo As IntPtr, ' BYTE* optional
dwClientInterfaceInfoSize As UInteger, ' DWORD optional
<MarshalAs(UnmanagedType.LPWStr)> lpwsDLLPath As String, ' LPWSTR optional
phRouterTransport As IntPtr ' HANDLE* out
) As UInteger
End Function' hMprConfig : HANDLE
' dwTransportId : DWORD
' lpwsTransportName : LPWSTR optional
' pGlobalInfo : BYTE*
' dwGlobalInfoSize : DWORD
' pClientInterfaceInfo : BYTE* optional
' dwClientInterfaceInfoSize : DWORD optional
' lpwsDLLPath : LPWSTR optional
' phRouterTransport : HANDLE* out
Declare PtrSafe Function MprConfigTransportCreate Lib "mprapi" ( _
ByVal hMprConfig As LongPtr, _
ByVal dwTransportId As Long, _
ByVal lpwsTransportName As LongPtr, _
ByVal pGlobalInfo As LongPtr, _
ByVal dwGlobalInfoSize As Long, _
ByVal pClientInterfaceInfo As LongPtr, _
ByVal dwClientInterfaceInfoSize As Long, _
ByVal lpwsDLLPath As LongPtr, _
ByVal phRouterTransport As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
MprConfigTransportCreate = ctypes.windll.mprapi.MprConfigTransportCreate
MprConfigTransportCreate.restype = wintypes.DWORD
MprConfigTransportCreate.argtypes = [
wintypes.HANDLE, # hMprConfig : HANDLE
wintypes.DWORD, # dwTransportId : DWORD
wintypes.LPCWSTR, # lpwsTransportName : LPWSTR optional
ctypes.POINTER(ctypes.c_ubyte), # pGlobalInfo : BYTE*
wintypes.DWORD, # dwGlobalInfoSize : DWORD
ctypes.POINTER(ctypes.c_ubyte), # pClientInterfaceInfo : BYTE* optional
wintypes.DWORD, # dwClientInterfaceInfoSize : DWORD optional
wintypes.LPCWSTR, # lpwsDLLPath : LPWSTR optional
ctypes.c_void_p, # phRouterTransport : HANDLE* out
]require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('MPRAPI.dll')
MprConfigTransportCreate = Fiddle::Function.new(
lib['MprConfigTransportCreate'],
[
Fiddle::TYPE_VOIDP, # hMprConfig : HANDLE
-Fiddle::TYPE_INT, # dwTransportId : DWORD
Fiddle::TYPE_VOIDP, # lpwsTransportName : LPWSTR optional
Fiddle::TYPE_VOIDP, # pGlobalInfo : BYTE*
-Fiddle::TYPE_INT, # dwGlobalInfoSize : DWORD
Fiddle::TYPE_VOIDP, # pClientInterfaceInfo : BYTE* optional
-Fiddle::TYPE_INT, # dwClientInterfaceInfoSize : DWORD optional
Fiddle::TYPE_VOIDP, # lpwsDLLPath : LPWSTR optional
Fiddle::TYPE_VOIDP, # phRouterTransport : HANDLE* out
],
-Fiddle::TYPE_INT)#[link(name = "mprapi")]
extern "system" {
fn MprConfigTransportCreate(
hMprConfig: *mut core::ffi::c_void, // HANDLE
dwTransportId: u32, // DWORD
lpwsTransportName: *mut u16, // LPWSTR optional
pGlobalInfo: *mut u8, // BYTE*
dwGlobalInfoSize: u32, // DWORD
pClientInterfaceInfo: *mut u8, // BYTE* optional
dwClientInterfaceInfoSize: u32, // DWORD optional
lpwsDLLPath: *mut u16, // LPWSTR optional
phRouterTransport: *mut *mut core::ffi::c_void // HANDLE* out
) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[DllImport("MPRAPI.dll")]
public static extern uint MprConfigTransportCreate(IntPtr hMprConfig, uint dwTransportId, [MarshalAs(UnmanagedType.LPWStr)] string lpwsTransportName, IntPtr pGlobalInfo, uint dwGlobalInfoSize, IntPtr pClientInterfaceInfo, uint dwClientInterfaceInfoSize, [MarshalAs(UnmanagedType.LPWStr)] string lpwsDLLPath, IntPtr phRouterTransport);
"@
$api = Add-Type -MemberDefinition $sig -Name 'MPRAPI_MprConfigTransportCreate' -Namespace Win32 -PassThru
# $api::MprConfigTransportCreate(hMprConfig, dwTransportId, lpwsTransportName, pGlobalInfo, dwGlobalInfoSize, pClientInterfaceInfo, dwClientInterfaceInfoSize, lpwsDLLPath, phRouterTransport)#uselib "MPRAPI.dll"
#func global MprConfigTransportCreate "MprConfigTransportCreate" sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; MprConfigTransportCreate hMprConfig, dwTransportId, lpwsTransportName, varptr(pGlobalInfo), dwGlobalInfoSize, varptr(pClientInterfaceInfo), dwClientInterfaceInfoSize, lpwsDLLPath, phRouterTransport ; 戻り値は stat
; hMprConfig : HANDLE -> "sptr"
; dwTransportId : DWORD -> "sptr"
; lpwsTransportName : LPWSTR optional -> "sptr"
; pGlobalInfo : BYTE* -> "sptr"
; dwGlobalInfoSize : DWORD -> "sptr"
; pClientInterfaceInfo : BYTE* optional -> "sptr"
; dwClientInterfaceInfoSize : DWORD optional -> "sptr"
; lpwsDLLPath : LPWSTR optional -> "sptr"
; phRouterTransport : HANDLE* out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。出力引数:
#uselib "MPRAPI.dll" #cfunc global MprConfigTransportCreate "MprConfigTransportCreate" sptr, int, wstr, var, int, var, int, wstr, sptr ; res = MprConfigTransportCreate(hMprConfig, dwTransportId, lpwsTransportName, pGlobalInfo, dwGlobalInfoSize, pClientInterfaceInfo, dwClientInterfaceInfoSize, lpwsDLLPath, phRouterTransport) ; hMprConfig : HANDLE -> "sptr" ; dwTransportId : DWORD -> "int" ; lpwsTransportName : LPWSTR optional -> "wstr" ; pGlobalInfo : BYTE* -> "var" ; dwGlobalInfoSize : DWORD -> "int" ; pClientInterfaceInfo : BYTE* optional -> "var" ; dwClientInterfaceInfoSize : DWORD optional -> "int" ; lpwsDLLPath : LPWSTR optional -> "wstr" ; phRouterTransport : HANDLE* out -> "sptr" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "MPRAPI.dll" #cfunc global MprConfigTransportCreate "MprConfigTransportCreate" sptr, int, wstr, sptr, int, sptr, int, wstr, sptr ; res = MprConfigTransportCreate(hMprConfig, dwTransportId, lpwsTransportName, varptr(pGlobalInfo), dwGlobalInfoSize, varptr(pClientInterfaceInfo), dwClientInterfaceInfoSize, lpwsDLLPath, phRouterTransport) ; hMprConfig : HANDLE -> "sptr" ; dwTransportId : DWORD -> "int" ; lpwsTransportName : LPWSTR optional -> "wstr" ; pGlobalInfo : BYTE* -> "sptr" ; dwGlobalInfoSize : DWORD -> "int" ; pClientInterfaceInfo : BYTE* optional -> "sptr" ; dwClientInterfaceInfoSize : DWORD optional -> "int" ; lpwsDLLPath : LPWSTR optional -> "wstr" ; phRouterTransport : HANDLE* out -> "sptr" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
出力引数:
; DWORD MprConfigTransportCreate(HANDLE hMprConfig, DWORD dwTransportId, LPWSTR lpwsTransportName, BYTE* pGlobalInfo, DWORD dwGlobalInfoSize, BYTE* pClientInterfaceInfo, DWORD dwClientInterfaceInfoSize, LPWSTR lpwsDLLPath, HANDLE* phRouterTransport) #uselib "MPRAPI.dll" #cfunc global MprConfigTransportCreate "MprConfigTransportCreate" intptr, int, wstr, var, int, var, int, wstr, intptr ; res = MprConfigTransportCreate(hMprConfig, dwTransportId, lpwsTransportName, pGlobalInfo, dwGlobalInfoSize, pClientInterfaceInfo, dwClientInterfaceInfoSize, lpwsDLLPath, phRouterTransport) ; hMprConfig : HANDLE -> "intptr" ; dwTransportId : DWORD -> "int" ; lpwsTransportName : LPWSTR optional -> "wstr" ; pGlobalInfo : BYTE* -> "var" ; dwGlobalInfoSize : DWORD -> "int" ; pClientInterfaceInfo : BYTE* optional -> "var" ; dwClientInterfaceInfoSize : DWORD optional -> "int" ; lpwsDLLPath : LPWSTR optional -> "wstr" ; phRouterTransport : HANDLE* out -> "intptr" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; DWORD MprConfigTransportCreate(HANDLE hMprConfig, DWORD dwTransportId, LPWSTR lpwsTransportName, BYTE* pGlobalInfo, DWORD dwGlobalInfoSize, BYTE* pClientInterfaceInfo, DWORD dwClientInterfaceInfoSize, LPWSTR lpwsDLLPath, HANDLE* phRouterTransport) #uselib "MPRAPI.dll" #cfunc global MprConfigTransportCreate "MprConfigTransportCreate" intptr, int, wstr, intptr, int, intptr, int, wstr, intptr ; res = MprConfigTransportCreate(hMprConfig, dwTransportId, lpwsTransportName, varptr(pGlobalInfo), dwGlobalInfoSize, varptr(pClientInterfaceInfo), dwClientInterfaceInfoSize, lpwsDLLPath, phRouterTransport) ; hMprConfig : HANDLE -> "intptr" ; dwTransportId : DWORD -> "int" ; lpwsTransportName : LPWSTR optional -> "wstr" ; pGlobalInfo : BYTE* -> "intptr" ; dwGlobalInfoSize : DWORD -> "int" ; pClientInterfaceInfo : BYTE* optional -> "intptr" ; dwClientInterfaceInfoSize : DWORD optional -> "int" ; lpwsDLLPath : LPWSTR optional -> "wstr" ; phRouterTransport : HANDLE* out -> "intptr" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
mprapi = windows.NewLazySystemDLL("MPRAPI.dll")
procMprConfigTransportCreate = mprapi.NewProc("MprConfigTransportCreate")
)
// hMprConfig (HANDLE), dwTransportId (DWORD), lpwsTransportName (LPWSTR optional), pGlobalInfo (BYTE*), dwGlobalInfoSize (DWORD), pClientInterfaceInfo (BYTE* optional), dwClientInterfaceInfoSize (DWORD optional), lpwsDLLPath (LPWSTR optional), phRouterTransport (HANDLE* out)
r1, _, err := procMprConfigTransportCreate.Call(
uintptr(hMprConfig),
uintptr(dwTransportId),
uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(lpwsTransportName))),
uintptr(pGlobalInfo),
uintptr(dwGlobalInfoSize),
uintptr(pClientInterfaceInfo),
uintptr(dwClientInterfaceInfoSize),
uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(lpwsDLLPath))),
uintptr(phRouterTransport),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // DWORDfunction MprConfigTransportCreate(
hMprConfig: THandle; // HANDLE
dwTransportId: DWORD; // DWORD
lpwsTransportName: PWideChar; // LPWSTR optional
pGlobalInfo: Pointer; // BYTE*
dwGlobalInfoSize: DWORD; // DWORD
pClientInterfaceInfo: Pointer; // BYTE* optional
dwClientInterfaceInfoSize: DWORD; // DWORD optional
lpwsDLLPath: PWideChar; // LPWSTR optional
phRouterTransport: Pointer // HANDLE* out
): DWORD; stdcall;
external 'MPRAPI.dll' name 'MprConfigTransportCreate';result := DllCall("MPRAPI\MprConfigTransportCreate"
, "Ptr", hMprConfig ; HANDLE
, "UInt", dwTransportId ; DWORD
, "WStr", lpwsTransportName ; LPWSTR optional
, "Ptr", pGlobalInfo ; BYTE*
, "UInt", dwGlobalInfoSize ; DWORD
, "Ptr", pClientInterfaceInfo ; BYTE* optional
, "UInt", dwClientInterfaceInfoSize ; DWORD optional
, "WStr", lpwsDLLPath ; LPWSTR optional
, "Ptr", phRouterTransport ; HANDLE* out
, "UInt") ; return: DWORD●MprConfigTransportCreate(hMprConfig, dwTransportId, lpwsTransportName, pGlobalInfo, dwGlobalInfoSize, pClientInterfaceInfo, dwClientInterfaceInfoSize, lpwsDLLPath, phRouterTransport) = DLL("MPRAPI.dll", "dword MprConfigTransportCreate(void*, dword, char*, void*, dword, void*, dword, char*, void*)")
# 呼び出し: MprConfigTransportCreate(hMprConfig, dwTransportId, lpwsTransportName, pGlobalInfo, dwGlobalInfoSize, pClientInterfaceInfo, dwClientInterfaceInfoSize, lpwsDLLPath, phRouterTransport)
# hMprConfig : HANDLE -> "void*"
# dwTransportId : DWORD -> "dword"
# lpwsTransportName : LPWSTR optional -> "char*"
# pGlobalInfo : BYTE* -> "void*"
# dwGlobalInfoSize : DWORD -> "dword"
# pClientInterfaceInfo : BYTE* optional -> "void*"
# dwClientInterfaceInfoSize : DWORD optional -> "dword"
# lpwsDLLPath : LPWSTR optional -> "char*"
# phRouterTransport : HANDLE* out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。const std = @import("std");
extern "mprapi" fn MprConfigTransportCreate(
hMprConfig: ?*anyopaque, // HANDLE
dwTransportId: u32, // DWORD
lpwsTransportName: [*c]const u16, // LPWSTR optional
pGlobalInfo: [*c]u8, // BYTE*
dwGlobalInfoSize: u32, // DWORD
pClientInterfaceInfo: [*c]u8, // BYTE* optional
dwClientInterfaceInfoSize: u32, // DWORD optional
lpwsDLLPath: [*c]const u16, // LPWSTR optional
phRouterTransport: ?*anyopaque // HANDLE* out
) callconv(std.os.windows.WINAPI) u32;proc MprConfigTransportCreate(
hMprConfig: pointer, # HANDLE
dwTransportId: uint32, # DWORD
lpwsTransportName: WideCString, # LPWSTR optional
pGlobalInfo: ptr uint8, # BYTE*
dwGlobalInfoSize: uint32, # DWORD
pClientInterfaceInfo: ptr uint8, # BYTE* optional
dwClientInterfaceInfoSize: uint32, # DWORD optional
lpwsDLLPath: WideCString, # LPWSTR optional
phRouterTransport: pointer # HANDLE* out
): uint32 {.importc: "MprConfigTransportCreate", stdcall, dynlib: "MPRAPI.dll".}pragma(lib, "mprapi");
extern(Windows)
uint MprConfigTransportCreate(
void* hMprConfig, // HANDLE
uint dwTransportId, // DWORD
const(wchar)* lpwsTransportName, // LPWSTR optional
ubyte* pGlobalInfo, // BYTE*
uint dwGlobalInfoSize, // DWORD
ubyte* pClientInterfaceInfo, // BYTE* optional
uint dwClientInterfaceInfoSize, // DWORD optional
const(wchar)* lpwsDLLPath, // LPWSTR optional
void* phRouterTransport // HANDLE* out
);ccall((:MprConfigTransportCreate, "MPRAPI.dll"), stdcall, UInt32,
(Ptr{Cvoid}, UInt32, Cwstring, Ptr{UInt8}, UInt32, Ptr{UInt8}, UInt32, Cwstring, Ptr{Cvoid}),
hMprConfig, dwTransportId, lpwsTransportName, pGlobalInfo, dwGlobalInfoSize, pClientInterfaceInfo, dwClientInterfaceInfoSize, lpwsDLLPath, phRouterTransport)
# hMprConfig : HANDLE -> Ptr{Cvoid}
# dwTransportId : DWORD -> UInt32
# lpwsTransportName : LPWSTR optional -> Cwstring
# pGlobalInfo : BYTE* -> Ptr{UInt8}
# dwGlobalInfoSize : DWORD -> UInt32
# pClientInterfaceInfo : BYTE* optional -> Ptr{UInt8}
# dwClientInterfaceInfoSize : DWORD optional -> UInt32
# lpwsDLLPath : LPWSTR optional -> Cwstring
# phRouterTransport : HANDLE* out -> Ptr{Cvoid}
# stdcall は 32bit のみ意味を持つ(x64 では無視)。local ffi = require("ffi")
ffi.cdef[[
uint32_t MprConfigTransportCreate(
void* hMprConfig,
uint32_t dwTransportId,
const uint16_t* lpwsTransportName,
uint8_t* pGlobalInfo,
uint32_t dwGlobalInfoSize,
uint8_t* pClientInterfaceInfo,
uint32_t dwClientInterfaceInfoSize,
const uint16_t* lpwsDLLPath,
void* phRouterTransport);
]]
local mprapi = ffi.load("mprapi")
-- mprapi.MprConfigTransportCreate(hMprConfig, dwTransportId, lpwsTransportName, pGlobalInfo, dwGlobalInfoSize, pClientInterfaceInfo, dwClientInterfaceInfoSize, lpwsDLLPath, phRouterTransport)
-- hMprConfig : HANDLE
-- dwTransportId : DWORD
-- lpwsTransportName : LPWSTR optional
-- pGlobalInfo : BYTE*
-- dwGlobalInfoSize : DWORD
-- pClientInterfaceInfo : BYTE* optional
-- dwClientInterfaceInfoSize : DWORD optional
-- lpwsDLLPath : LPWSTR optional
-- phRouterTransport : HANDLE* out
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。const koffi = require('koffi');
const lib = koffi.load('MPRAPI.dll');
const MprConfigTransportCreate = lib.func('__stdcall', 'MprConfigTransportCreate', 'uint32_t', ['void *', 'uint32_t', 'str16', 'uint8_t *', 'uint32_t', 'uint8_t *', 'uint32_t', 'str16', 'void *']);
// MprConfigTransportCreate(hMprConfig, dwTransportId, lpwsTransportName, pGlobalInfo, dwGlobalInfoSize, pClientInterfaceInfo, dwClientInterfaceInfoSize, lpwsDLLPath, phRouterTransport)
// hMprConfig : HANDLE -> 'void *'
// dwTransportId : DWORD -> 'uint32_t'
// lpwsTransportName : LPWSTR optional -> 'str16'
// pGlobalInfo : BYTE* -> 'uint8_t *'
// dwGlobalInfoSize : DWORD -> 'uint32_t'
// pClientInterfaceInfo : BYTE* optional -> 'uint8_t *'
// dwClientInterfaceInfoSize : DWORD optional -> 'uint32_t'
// lpwsDLLPath : LPWSTR optional -> 'str16'
// phRouterTransport : HANDLE* out -> 'void *'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。const lib = Deno.dlopen("MPRAPI.dll", {
MprConfigTransportCreate: { parameters: ["pointer", "u32", "buffer", "pointer", "u32", "pointer", "u32", "buffer", "pointer"], result: "u32" },
});
// lib.symbols.MprConfigTransportCreate(hMprConfig, dwTransportId, lpwsTransportName, pGlobalInfo, dwGlobalInfoSize, pClientInterfaceInfo, dwClientInterfaceInfoSize, lpwsDLLPath, phRouterTransport)
// hMprConfig : HANDLE -> "pointer"
// dwTransportId : DWORD -> "u32"
// lpwsTransportName : LPWSTR optional -> "buffer"
// pGlobalInfo : BYTE* -> "pointer"
// dwGlobalInfoSize : DWORD -> "u32"
// pClientInterfaceInfo : BYTE* optional -> "pointer"
// dwClientInterfaceInfoSize : DWORD optional -> "u32"
// lpwsDLLPath : LPWSTR optional -> "buffer"
// phRouterTransport : HANDLE* out -> "pointer"
// 文字列引数は "buffer"(NUL 終端のバイト列を Uint8Array で渡す)。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。<?php
$ffi = FFI::cdef(<<<C
uint32_t MprConfigTransportCreate(
void* hMprConfig,
uint32_t dwTransportId,
const uint16_t* lpwsTransportName,
uint8_t* pGlobalInfo,
uint32_t dwGlobalInfoSize,
uint8_t* pClientInterfaceInfo,
uint32_t dwClientInterfaceInfoSize,
const uint16_t* lpwsDLLPath,
void* phRouterTransport);
C, "MPRAPI.dll");
// $ffi->MprConfigTransportCreate(hMprConfig, dwTransportId, lpwsTransportName, pGlobalInfo, dwGlobalInfoSize, pClientInterfaceInfo, dwClientInterfaceInfoSize, lpwsDLLPath, phRouterTransport);
// hMprConfig : HANDLE
// dwTransportId : DWORD
// lpwsTransportName : LPWSTR optional
// pGlobalInfo : BYTE*
// dwGlobalInfoSize : DWORD
// pClientInterfaceInfo : BYTE* optional
// dwClientInterfaceInfoSize : DWORD optional
// lpwsDLLPath : LPWSTR optional
// phRouterTransport : HANDLE* 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 Mprapi extends StdCallLibrary {
Mprapi INSTANCE = Native.load("mprapi", Mprapi.class);
int MprConfigTransportCreate(
Pointer hMprConfig, // HANDLE
int dwTransportId, // DWORD
WString lpwsTransportName, // LPWSTR optional
byte[] pGlobalInfo, // BYTE*
int dwGlobalInfoSize, // DWORD
byte[] pClientInterfaceInfo, // BYTE* optional
int dwClientInterfaceInfoSize, // DWORD optional
WString lpwsDLLPath, // LPWSTR optional
Pointer phRouterTransport // HANDLE* out
);
}@[Link("mprapi")]
lib LibMPRAPI
fun MprConfigTransportCreate = MprConfigTransportCreate(
hMprConfig : Void*, # HANDLE
dwTransportId : UInt32, # DWORD
lpwsTransportName : UInt16*, # LPWSTR optional
pGlobalInfo : UInt8*, # BYTE*
dwGlobalInfoSize : UInt32, # DWORD
pClientInterfaceInfo : UInt8*, # BYTE* optional
dwClientInterfaceInfoSize : UInt32, # DWORD optional
lpwsDLLPath : UInt16*, # LPWSTR optional
phRouterTransport : Void* # HANDLE* out
) : UInt32
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。import 'dart:ffi';
import 'package:ffi/ffi.dart';
typedef MprConfigTransportCreateNative = Uint32 Function(Pointer<Void>, Uint32, Pointer<Utf16>, Pointer<Uint8>, Uint32, Pointer<Uint8>, Uint32, Pointer<Utf16>, Pointer<Void>);
typedef MprConfigTransportCreateDart = int Function(Pointer<Void>, int, Pointer<Utf16>, Pointer<Uint8>, int, Pointer<Uint8>, int, Pointer<Utf16>, Pointer<Void>);
final MprConfigTransportCreate = DynamicLibrary.open('MPRAPI.dll')
.lookupFunction<MprConfigTransportCreateNative, MprConfigTransportCreateDart>('MprConfigTransportCreate');
// hMprConfig : HANDLE -> Pointer<Void>
// dwTransportId : DWORD -> Uint32
// lpwsTransportName : LPWSTR optional -> Pointer<Utf16>
// pGlobalInfo : BYTE* -> Pointer<Uint8>
// dwGlobalInfoSize : DWORD -> Uint32
// pClientInterfaceInfo : BYTE* optional -> Pointer<Uint8>
// dwClientInterfaceInfoSize : DWORD optional -> Uint32
// lpwsDLLPath : LPWSTR optional -> Pointer<Utf16>
// phRouterTransport : HANDLE* out -> Pointer<Void>
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。{$mode objfpc}{$H+}
function MprConfigTransportCreate(
hMprConfig: THandle; // HANDLE
dwTransportId: DWORD; // DWORD
lpwsTransportName: PWideChar; // LPWSTR optional
pGlobalInfo: Pointer; // BYTE*
dwGlobalInfoSize: DWORD; // DWORD
pClientInterfaceInfo: Pointer; // BYTE* optional
dwClientInterfaceInfoSize: DWORD; // DWORD optional
lpwsDLLPath: PWideChar; // LPWSTR optional
phRouterTransport: Pointer // HANDLE* out
): DWORD; stdcall;
external 'MPRAPI.dll' name 'MprConfigTransportCreate';import Foreign
import Foreign.C.Types
import Foreign.C.String
foreign import stdcall safe "MprConfigTransportCreate"
c_MprConfigTransportCreate :: Ptr () -> Word32 -> CWString -> Ptr Word8 -> Word32 -> Ptr Word8 -> Word32 -> CWString -> Ptr () -> IO Word32
-- hMprConfig : HANDLE -> Ptr ()
-- dwTransportId : DWORD -> Word32
-- lpwsTransportName : LPWSTR optional -> CWString
-- pGlobalInfo : BYTE* -> Ptr Word8
-- dwGlobalInfoSize : DWORD -> Word32
-- pClientInterfaceInfo : BYTE* optional -> Ptr Word8
-- dwClientInterfaceInfoSize : DWORD optional -> Word32
-- lpwsDLLPath : LPWSTR optional -> CWString
-- phRouterTransport : HANDLE* out -> Ptr ()
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。open Ctypes
open Foreign
let mprconfigtransportcreate =
foreign "MprConfigTransportCreate"
((ptr void) @-> uint32_t @-> (ptr uint16_t) @-> (ptr uint8_t) @-> uint32_t @-> (ptr uint8_t) @-> uint32_t @-> (ptr uint16_t) @-> (ptr void) @-> returning uint32_t)
(* hMprConfig : HANDLE -> (ptr void) *)
(* dwTransportId : DWORD -> uint32_t *)
(* lpwsTransportName : LPWSTR optional -> (ptr uint16_t) *)
(* pGlobalInfo : BYTE* -> (ptr uint8_t) *)
(* dwGlobalInfoSize : DWORD -> uint32_t *)
(* pClientInterfaceInfo : BYTE* optional -> (ptr uint8_t) *)
(* dwClientInterfaceInfoSize : DWORD optional -> uint32_t *)
(* lpwsDLLPath : LPWSTR optional -> (ptr uint16_t) *)
(* phRouterTransport : HANDLE* out -> (ptr void) *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)(cffi:define-foreign-library mprapi (t "MPRAPI.dll"))
(cffi:use-foreign-library mprapi)
(cffi:defcfun ("MprConfigTransportCreate" mpr-config-transport-create :convention :stdcall) :uint32
(h-mpr-config :pointer) ; HANDLE
(dw-transport-id :uint32) ; DWORD
(lpws-transport-name (:string :encoding :utf-16le)) ; LPWSTR optional
(p-global-info :pointer) ; BYTE*
(dw-global-info-size :uint32) ; DWORD
(p-client-interface-info :pointer) ; BYTE* optional
(dw-client-interface-info-size :uint32) ; DWORD optional
(lpws-dllpath (:string :encoding :utf-16le)) ; LPWSTR optional
(ph-router-transport :pointer)) ; HANDLE* out
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。use Win32::API;
my $MprConfigTransportCreate = Win32::API::More->new('MPRAPI',
'DWORD MprConfigTransportCreate(HANDLE hMprConfig, DWORD dwTransportId, LPCWSTR lpwsTransportName, LPVOID pGlobalInfo, DWORD dwGlobalInfoSize, LPVOID pClientInterfaceInfo, DWORD dwClientInterfaceInfoSize, LPCWSTR lpwsDLLPath, HANDLE phRouterTransport)');
# my $ret = $MprConfigTransportCreate->Call($hMprConfig, $dwTransportId, $lpwsTransportName, $pGlobalInfo, $dwGlobalInfoSize, $pClientInterfaceInfo, $dwClientInterfaceInfoSize, $lpwsDLLPath, $phRouterTransport);
# hMprConfig : HANDLE -> HANDLE
# dwTransportId : DWORD -> DWORD
# lpwsTransportName : LPWSTR optional -> LPCWSTR
# pGlobalInfo : BYTE* -> LPVOID
# dwGlobalInfoSize : DWORD -> DWORD
# pClientInterfaceInfo : BYTE* optional -> LPVOID
# dwClientInterfaceInfoSize : DWORD optional -> DWORD
# lpwsDLLPath : LPWSTR optional -> LPCWSTR
# phRouterTransport : HANDLE* out -> HANDLE
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。