ホーム › NetworkManagement.Rras › MprConfigInterfaceTransportAdd
MprConfigInterfaceTransportAdd
関数構成内のインターフェイスにトランスポートを追加する。
シグネチャ
// MPRAPI.dll
#include <windows.h>
DWORD MprConfigInterfaceTransportAdd(
HANDLE hMprConfig,
HANDLE hRouterInterface,
DWORD dwTransportId,
LPWSTR lpwsTransportName, // optional
BYTE* pInterfaceInfo,
DWORD dwInterfaceInfoSize,
HANDLE* phRouterIfTransport
);パラメーター
| 名前 | 型 | 方向 |
|---|---|---|
| hMprConfig | HANDLE | in |
| hRouterInterface | HANDLE | in |
| dwTransportId | DWORD | in |
| lpwsTransportName | LPWSTR | inoptional |
| pInterfaceInfo | BYTE* | in |
| dwInterfaceInfoSize | DWORD | in |
| phRouterIfTransport | HANDLE* | out |
戻り値の型: DWORD
各言語での呼び出し定義
// MPRAPI.dll
#include <windows.h>
DWORD MprConfigInterfaceTransportAdd(
HANDLE hMprConfig,
HANDLE hRouterInterface,
DWORD dwTransportId,
LPWSTR lpwsTransportName, // optional
BYTE* pInterfaceInfo,
DWORD dwInterfaceInfoSize,
HANDLE* phRouterIfTransport
);[DllImport("MPRAPI.dll", ExactSpelling = true)]
static extern uint MprConfigInterfaceTransportAdd(
IntPtr hMprConfig, // HANDLE
IntPtr hRouterInterface, // HANDLE
uint dwTransportId, // DWORD
[MarshalAs(UnmanagedType.LPWStr)] string lpwsTransportName, // LPWSTR optional
IntPtr pInterfaceInfo, // BYTE*
uint dwInterfaceInfoSize, // DWORD
IntPtr phRouterIfTransport // HANDLE* out
);<DllImport("MPRAPI.dll", ExactSpelling:=True)>
Public Shared Function MprConfigInterfaceTransportAdd(
hMprConfig As IntPtr, ' HANDLE
hRouterInterface As IntPtr, ' HANDLE
dwTransportId As UInteger, ' DWORD
<MarshalAs(UnmanagedType.LPWStr)> lpwsTransportName As String, ' LPWSTR optional
pInterfaceInfo As IntPtr, ' BYTE*
dwInterfaceInfoSize As UInteger, ' DWORD
phRouterIfTransport As IntPtr ' HANDLE* out
) As UInteger
End Function' hMprConfig : HANDLE
' hRouterInterface : HANDLE
' dwTransportId : DWORD
' lpwsTransportName : LPWSTR optional
' pInterfaceInfo : BYTE*
' dwInterfaceInfoSize : DWORD
' phRouterIfTransport : HANDLE* out
Declare PtrSafe Function MprConfigInterfaceTransportAdd Lib "mprapi" ( _
ByVal hMprConfig As LongPtr, _
ByVal hRouterInterface As LongPtr, _
ByVal dwTransportId As Long, _
ByVal lpwsTransportName As LongPtr, _
ByVal pInterfaceInfo As LongPtr, _
ByVal dwInterfaceInfoSize As Long, _
ByVal phRouterIfTransport As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
MprConfigInterfaceTransportAdd = ctypes.windll.mprapi.MprConfigInterfaceTransportAdd
MprConfigInterfaceTransportAdd.restype = wintypes.DWORD
MprConfigInterfaceTransportAdd.argtypes = [
wintypes.HANDLE, # hMprConfig : HANDLE
wintypes.HANDLE, # hRouterInterface : HANDLE
wintypes.DWORD, # dwTransportId : DWORD
wintypes.LPCWSTR, # lpwsTransportName : LPWSTR optional
ctypes.POINTER(ctypes.c_ubyte), # pInterfaceInfo : BYTE*
wintypes.DWORD, # dwInterfaceInfoSize : DWORD
ctypes.c_void_p, # phRouterIfTransport : HANDLE* out
]require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('MPRAPI.dll')
MprConfigInterfaceTransportAdd = Fiddle::Function.new(
lib['MprConfigInterfaceTransportAdd'],
[
Fiddle::TYPE_VOIDP, # hMprConfig : HANDLE
Fiddle::TYPE_VOIDP, # hRouterInterface : HANDLE
-Fiddle::TYPE_INT, # dwTransportId : DWORD
Fiddle::TYPE_VOIDP, # lpwsTransportName : LPWSTR optional
Fiddle::TYPE_VOIDP, # pInterfaceInfo : BYTE*
-Fiddle::TYPE_INT, # dwInterfaceInfoSize : DWORD
Fiddle::TYPE_VOIDP, # phRouterIfTransport : HANDLE* out
],
-Fiddle::TYPE_INT)#[link(name = "mprapi")]
extern "system" {
fn MprConfigInterfaceTransportAdd(
hMprConfig: *mut core::ffi::c_void, // HANDLE
hRouterInterface: *mut core::ffi::c_void, // HANDLE
dwTransportId: u32, // DWORD
lpwsTransportName: *mut u16, // LPWSTR optional
pInterfaceInfo: *mut u8, // BYTE*
dwInterfaceInfoSize: u32, // DWORD
phRouterIfTransport: *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 MprConfigInterfaceTransportAdd(IntPtr hMprConfig, IntPtr hRouterInterface, uint dwTransportId, [MarshalAs(UnmanagedType.LPWStr)] string lpwsTransportName, IntPtr pInterfaceInfo, uint dwInterfaceInfoSize, IntPtr phRouterIfTransport);
"@
$api = Add-Type -MemberDefinition $sig -Name 'MPRAPI_MprConfigInterfaceTransportAdd' -Namespace Win32 -PassThru
# $api::MprConfigInterfaceTransportAdd(hMprConfig, hRouterInterface, dwTransportId, lpwsTransportName, pInterfaceInfo, dwInterfaceInfoSize, phRouterIfTransport)#uselib "MPRAPI.dll"
#func global MprConfigInterfaceTransportAdd "MprConfigInterfaceTransportAdd" sptr, sptr, sptr, sptr, sptr, sptr, sptr
; MprConfigInterfaceTransportAdd hMprConfig, hRouterInterface, dwTransportId, lpwsTransportName, varptr(pInterfaceInfo), dwInterfaceInfoSize, phRouterIfTransport ; 戻り値は stat
; hMprConfig : HANDLE -> "sptr"
; hRouterInterface : HANDLE -> "sptr"
; dwTransportId : DWORD -> "sptr"
; lpwsTransportName : LPWSTR optional -> "sptr"
; pInterfaceInfo : BYTE* -> "sptr"
; dwInterfaceInfoSize : DWORD -> "sptr"
; phRouterIfTransport : HANDLE* out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。出力引数:
#uselib "MPRAPI.dll" #cfunc global MprConfigInterfaceTransportAdd "MprConfigInterfaceTransportAdd" sptr, sptr, int, wstr, var, int, sptr ; res = MprConfigInterfaceTransportAdd(hMprConfig, hRouterInterface, dwTransportId, lpwsTransportName, pInterfaceInfo, dwInterfaceInfoSize, phRouterIfTransport) ; hMprConfig : HANDLE -> "sptr" ; hRouterInterface : HANDLE -> "sptr" ; dwTransportId : DWORD -> "int" ; lpwsTransportName : LPWSTR optional -> "wstr" ; pInterfaceInfo : BYTE* -> "var" ; dwInterfaceInfoSize : DWORD -> "int" ; phRouterIfTransport : HANDLE* out -> "sptr" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "MPRAPI.dll" #cfunc global MprConfigInterfaceTransportAdd "MprConfigInterfaceTransportAdd" sptr, sptr, int, wstr, sptr, int, sptr ; res = MprConfigInterfaceTransportAdd(hMprConfig, hRouterInterface, dwTransportId, lpwsTransportName, varptr(pInterfaceInfo), dwInterfaceInfoSize, phRouterIfTransport) ; hMprConfig : HANDLE -> "sptr" ; hRouterInterface : HANDLE -> "sptr" ; dwTransportId : DWORD -> "int" ; lpwsTransportName : LPWSTR optional -> "wstr" ; pInterfaceInfo : BYTE* -> "sptr" ; dwInterfaceInfoSize : DWORD -> "int" ; phRouterIfTransport : HANDLE* out -> "sptr" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
出力引数:
; DWORD MprConfigInterfaceTransportAdd(HANDLE hMprConfig, HANDLE hRouterInterface, DWORD dwTransportId, LPWSTR lpwsTransportName, BYTE* pInterfaceInfo, DWORD dwInterfaceInfoSize, HANDLE* phRouterIfTransport) #uselib "MPRAPI.dll" #cfunc global MprConfigInterfaceTransportAdd "MprConfigInterfaceTransportAdd" intptr, intptr, int, wstr, var, int, intptr ; res = MprConfigInterfaceTransportAdd(hMprConfig, hRouterInterface, dwTransportId, lpwsTransportName, pInterfaceInfo, dwInterfaceInfoSize, phRouterIfTransport) ; hMprConfig : HANDLE -> "intptr" ; hRouterInterface : HANDLE -> "intptr" ; dwTransportId : DWORD -> "int" ; lpwsTransportName : LPWSTR optional -> "wstr" ; pInterfaceInfo : BYTE* -> "var" ; dwInterfaceInfoSize : DWORD -> "int" ; phRouterIfTransport : HANDLE* out -> "intptr" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; DWORD MprConfigInterfaceTransportAdd(HANDLE hMprConfig, HANDLE hRouterInterface, DWORD dwTransportId, LPWSTR lpwsTransportName, BYTE* pInterfaceInfo, DWORD dwInterfaceInfoSize, HANDLE* phRouterIfTransport) #uselib "MPRAPI.dll" #cfunc global MprConfigInterfaceTransportAdd "MprConfigInterfaceTransportAdd" intptr, intptr, int, wstr, intptr, int, intptr ; res = MprConfigInterfaceTransportAdd(hMprConfig, hRouterInterface, dwTransportId, lpwsTransportName, varptr(pInterfaceInfo), dwInterfaceInfoSize, phRouterIfTransport) ; hMprConfig : HANDLE -> "intptr" ; hRouterInterface : HANDLE -> "intptr" ; dwTransportId : DWORD -> "int" ; lpwsTransportName : LPWSTR optional -> "wstr" ; pInterfaceInfo : BYTE* -> "intptr" ; dwInterfaceInfoSize : DWORD -> "int" ; phRouterIfTransport : HANDLE* out -> "intptr" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
mprapi = windows.NewLazySystemDLL("MPRAPI.dll")
procMprConfigInterfaceTransportAdd = mprapi.NewProc("MprConfigInterfaceTransportAdd")
)
// hMprConfig (HANDLE), hRouterInterface (HANDLE), dwTransportId (DWORD), lpwsTransportName (LPWSTR optional), pInterfaceInfo (BYTE*), dwInterfaceInfoSize (DWORD), phRouterIfTransport (HANDLE* out)
r1, _, err := procMprConfigInterfaceTransportAdd.Call(
uintptr(hMprConfig),
uintptr(hRouterInterface),
uintptr(dwTransportId),
uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(lpwsTransportName))),
uintptr(pInterfaceInfo),
uintptr(dwInterfaceInfoSize),
uintptr(phRouterIfTransport),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // DWORDfunction MprConfigInterfaceTransportAdd(
hMprConfig: THandle; // HANDLE
hRouterInterface: THandle; // HANDLE
dwTransportId: DWORD; // DWORD
lpwsTransportName: PWideChar; // LPWSTR optional
pInterfaceInfo: Pointer; // BYTE*
dwInterfaceInfoSize: DWORD; // DWORD
phRouterIfTransport: Pointer // HANDLE* out
): DWORD; stdcall;
external 'MPRAPI.dll' name 'MprConfigInterfaceTransportAdd';result := DllCall("MPRAPI\MprConfigInterfaceTransportAdd"
, "Ptr", hMprConfig ; HANDLE
, "Ptr", hRouterInterface ; HANDLE
, "UInt", dwTransportId ; DWORD
, "WStr", lpwsTransportName ; LPWSTR optional
, "Ptr", pInterfaceInfo ; BYTE*
, "UInt", dwInterfaceInfoSize ; DWORD
, "Ptr", phRouterIfTransport ; HANDLE* out
, "UInt") ; return: DWORD●MprConfigInterfaceTransportAdd(hMprConfig, hRouterInterface, dwTransportId, lpwsTransportName, pInterfaceInfo, dwInterfaceInfoSize, phRouterIfTransport) = DLL("MPRAPI.dll", "dword MprConfigInterfaceTransportAdd(void*, void*, dword, char*, void*, dword, void*)")
# 呼び出し: MprConfigInterfaceTransportAdd(hMprConfig, hRouterInterface, dwTransportId, lpwsTransportName, pInterfaceInfo, dwInterfaceInfoSize, phRouterIfTransport)
# hMprConfig : HANDLE -> "void*"
# hRouterInterface : HANDLE -> "void*"
# dwTransportId : DWORD -> "dword"
# lpwsTransportName : LPWSTR optional -> "char*"
# pInterfaceInfo : BYTE* -> "void*"
# dwInterfaceInfoSize : DWORD -> "dword"
# phRouterIfTransport : HANDLE* out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。