ホーム › NetworkManagement.Rras › MprAdminTransportGetInfo
MprAdminTransportGetInfo
関数ルーターのトランスポートの構成情報を取得する。
シグネチャ
// MPRAPI.dll
#include <windows.h>
DWORD MprAdminTransportGetInfo(
INT_PTR hMprServer,
DWORD dwTransportId,
BYTE** ppGlobalInfo, // optional
DWORD* lpdwGlobalInfoSize, // optional
BYTE** ppClientInterfaceInfo, // optional
DWORD* lpdwClientInterfaceInfoSize // optional
);パラメーター
| 名前 | 型 | 方向 |
|---|---|---|
| hMprServer | INT_PTR | in |
| dwTransportId | DWORD | in |
| ppGlobalInfo | BYTE** | outoptional |
| lpdwGlobalInfoSize | DWORD* | outoptional |
| ppClientInterfaceInfo | BYTE** | outoptional |
| lpdwClientInterfaceInfoSize | DWORD* | outoptional |
戻り値の型: DWORD
各言語での呼び出し定義
// MPRAPI.dll
#include <windows.h>
DWORD MprAdminTransportGetInfo(
INT_PTR hMprServer,
DWORD dwTransportId,
BYTE** ppGlobalInfo, // optional
DWORD* lpdwGlobalInfoSize, // optional
BYTE** ppClientInterfaceInfo, // optional
DWORD* lpdwClientInterfaceInfoSize // optional
);[DllImport("MPRAPI.dll", ExactSpelling = true)]
static extern uint MprAdminTransportGetInfo(
IntPtr hMprServer, // INT_PTR
uint dwTransportId, // DWORD
IntPtr ppGlobalInfo, // BYTE** optional, out
IntPtr lpdwGlobalInfoSize, // DWORD* optional, out
IntPtr ppClientInterfaceInfo, // BYTE** optional, out
IntPtr lpdwClientInterfaceInfoSize // DWORD* optional, out
);<DllImport("MPRAPI.dll", ExactSpelling:=True)>
Public Shared Function MprAdminTransportGetInfo(
hMprServer As IntPtr, ' INT_PTR
dwTransportId As UInteger, ' DWORD
ppGlobalInfo As IntPtr, ' BYTE** optional, out
lpdwGlobalInfoSize As IntPtr, ' DWORD* optional, out
ppClientInterfaceInfo As IntPtr, ' BYTE** optional, out
lpdwClientInterfaceInfoSize As IntPtr ' DWORD* optional, out
) As UInteger
End Function' hMprServer : INT_PTR
' dwTransportId : DWORD
' ppGlobalInfo : BYTE** optional, out
' lpdwGlobalInfoSize : DWORD* optional, out
' ppClientInterfaceInfo : BYTE** optional, out
' lpdwClientInterfaceInfoSize : DWORD* optional, out
Declare PtrSafe Function MprAdminTransportGetInfo Lib "mprapi" ( _
ByVal hMprServer As LongPtr, _
ByVal dwTransportId As Long, _
ByVal ppGlobalInfo As LongPtr, _
ByVal lpdwGlobalInfoSize As LongPtr, _
ByVal ppClientInterfaceInfo As LongPtr, _
ByVal lpdwClientInterfaceInfoSize As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
MprAdminTransportGetInfo = ctypes.windll.mprapi.MprAdminTransportGetInfo
MprAdminTransportGetInfo.restype = wintypes.DWORD
MprAdminTransportGetInfo.argtypes = [
ctypes.c_ssize_t, # hMprServer : INT_PTR
wintypes.DWORD, # dwTransportId : DWORD
ctypes.c_void_p, # ppGlobalInfo : BYTE** optional, out
ctypes.POINTER(wintypes.DWORD), # lpdwGlobalInfoSize : DWORD* optional, out
ctypes.c_void_p, # ppClientInterfaceInfo : BYTE** optional, out
ctypes.POINTER(wintypes.DWORD), # lpdwClientInterfaceInfoSize : DWORD* optional, out
]require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('MPRAPI.dll')
MprAdminTransportGetInfo = Fiddle::Function.new(
lib['MprAdminTransportGetInfo'],
[
Fiddle::TYPE_INTPTR_T, # hMprServer : INT_PTR
-Fiddle::TYPE_INT, # dwTransportId : DWORD
Fiddle::TYPE_VOIDP, # ppGlobalInfo : BYTE** optional, out
Fiddle::TYPE_VOIDP, # lpdwGlobalInfoSize : DWORD* optional, out
Fiddle::TYPE_VOIDP, # ppClientInterfaceInfo : BYTE** optional, out
Fiddle::TYPE_VOIDP, # lpdwClientInterfaceInfoSize : DWORD* optional, out
],
-Fiddle::TYPE_INT)#[link(name = "mprapi")]
extern "system" {
fn MprAdminTransportGetInfo(
hMprServer: isize, // INT_PTR
dwTransportId: u32, // DWORD
ppGlobalInfo: *mut *mut u8, // BYTE** optional, out
lpdwGlobalInfoSize: *mut u32, // DWORD* optional, out
ppClientInterfaceInfo: *mut *mut u8, // BYTE** optional, out
lpdwClientInterfaceInfoSize: *mut u32 // DWORD* optional, out
) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[DllImport("MPRAPI.dll")]
public static extern uint MprAdminTransportGetInfo(IntPtr hMprServer, uint dwTransportId, IntPtr ppGlobalInfo, IntPtr lpdwGlobalInfoSize, IntPtr ppClientInterfaceInfo, IntPtr lpdwClientInterfaceInfoSize);
"@
$api = Add-Type -MemberDefinition $sig -Name 'MPRAPI_MprAdminTransportGetInfo' -Namespace Win32 -PassThru
# $api::MprAdminTransportGetInfo(hMprServer, dwTransportId, ppGlobalInfo, lpdwGlobalInfoSize, ppClientInterfaceInfo, lpdwClientInterfaceInfoSize)#uselib "MPRAPI.dll"
#func global MprAdminTransportGetInfo "MprAdminTransportGetInfo" sptr, sptr, sptr, sptr, sptr, sptr
; MprAdminTransportGetInfo hMprServer, dwTransportId, varptr(ppGlobalInfo), varptr(lpdwGlobalInfoSize), varptr(ppClientInterfaceInfo), varptr(lpdwClientInterfaceInfoSize) ; 戻り値は stat
; hMprServer : INT_PTR -> "sptr"
; dwTransportId : DWORD -> "sptr"
; ppGlobalInfo : BYTE** optional, out -> "sptr"
; lpdwGlobalInfoSize : DWORD* optional, out -> "sptr"
; ppClientInterfaceInfo : BYTE** optional, out -> "sptr"
; lpdwClientInterfaceInfoSize : DWORD* optional, out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。出力引数:
#uselib "MPRAPI.dll" #cfunc global MprAdminTransportGetInfo "MprAdminTransportGetInfo" sptr, int, var, var, var, var ; res = MprAdminTransportGetInfo(hMprServer, dwTransportId, ppGlobalInfo, lpdwGlobalInfoSize, ppClientInterfaceInfo, lpdwClientInterfaceInfoSize) ; hMprServer : INT_PTR -> "sptr" ; dwTransportId : DWORD -> "int" ; ppGlobalInfo : BYTE** optional, out -> "var" ; lpdwGlobalInfoSize : DWORD* optional, out -> "var" ; ppClientInterfaceInfo : BYTE** optional, out -> "var" ; lpdwClientInterfaceInfoSize : DWORD* optional, out -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "MPRAPI.dll" #cfunc global MprAdminTransportGetInfo "MprAdminTransportGetInfo" sptr, int, sptr, sptr, sptr, sptr ; res = MprAdminTransportGetInfo(hMprServer, dwTransportId, varptr(ppGlobalInfo), varptr(lpdwGlobalInfoSize), varptr(ppClientInterfaceInfo), varptr(lpdwClientInterfaceInfoSize)) ; hMprServer : INT_PTR -> "sptr" ; dwTransportId : DWORD -> "int" ; ppGlobalInfo : BYTE** optional, out -> "sptr" ; lpdwGlobalInfoSize : DWORD* optional, out -> "sptr" ; ppClientInterfaceInfo : BYTE** optional, out -> "sptr" ; lpdwClientInterfaceInfoSize : DWORD* optional, out -> "sptr" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
出力引数:
; DWORD MprAdminTransportGetInfo(INT_PTR hMprServer, DWORD dwTransportId, BYTE** ppGlobalInfo, DWORD* lpdwGlobalInfoSize, BYTE** ppClientInterfaceInfo, DWORD* lpdwClientInterfaceInfoSize) #uselib "MPRAPI.dll" #cfunc global MprAdminTransportGetInfo "MprAdminTransportGetInfo" intptr, int, var, var, var, var ; res = MprAdminTransportGetInfo(hMprServer, dwTransportId, ppGlobalInfo, lpdwGlobalInfoSize, ppClientInterfaceInfo, lpdwClientInterfaceInfoSize) ; hMprServer : INT_PTR -> "intptr" ; dwTransportId : DWORD -> "int" ; ppGlobalInfo : BYTE** optional, out -> "var" ; lpdwGlobalInfoSize : DWORD* optional, out -> "var" ; ppClientInterfaceInfo : BYTE** optional, out -> "var" ; lpdwClientInterfaceInfoSize : DWORD* optional, out -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; DWORD MprAdminTransportGetInfo(INT_PTR hMprServer, DWORD dwTransportId, BYTE** ppGlobalInfo, DWORD* lpdwGlobalInfoSize, BYTE** ppClientInterfaceInfo, DWORD* lpdwClientInterfaceInfoSize) #uselib "MPRAPI.dll" #cfunc global MprAdminTransportGetInfo "MprAdminTransportGetInfo" intptr, int, intptr, intptr, intptr, intptr ; res = MprAdminTransportGetInfo(hMprServer, dwTransportId, varptr(ppGlobalInfo), varptr(lpdwGlobalInfoSize), varptr(ppClientInterfaceInfo), varptr(lpdwClientInterfaceInfoSize)) ; hMprServer : INT_PTR -> "intptr" ; dwTransportId : DWORD -> "int" ; ppGlobalInfo : BYTE** optional, out -> "intptr" ; lpdwGlobalInfoSize : DWORD* optional, out -> "intptr" ; ppClientInterfaceInfo : BYTE** optional, out -> "intptr" ; lpdwClientInterfaceInfoSize : DWORD* optional, out -> "intptr" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
mprapi = windows.NewLazySystemDLL("MPRAPI.dll")
procMprAdminTransportGetInfo = mprapi.NewProc("MprAdminTransportGetInfo")
)
// hMprServer (INT_PTR), dwTransportId (DWORD), ppGlobalInfo (BYTE** optional, out), lpdwGlobalInfoSize (DWORD* optional, out), ppClientInterfaceInfo (BYTE** optional, out), lpdwClientInterfaceInfoSize (DWORD* optional, out)
r1, _, err := procMprAdminTransportGetInfo.Call(
uintptr(hMprServer),
uintptr(dwTransportId),
uintptr(ppGlobalInfo),
uintptr(lpdwGlobalInfoSize),
uintptr(ppClientInterfaceInfo),
uintptr(lpdwClientInterfaceInfoSize),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // DWORDfunction MprAdminTransportGetInfo(
hMprServer: NativeInt; // INT_PTR
dwTransportId: DWORD; // DWORD
ppGlobalInfo: Pointer; // BYTE** optional, out
lpdwGlobalInfoSize: Pointer; // DWORD* optional, out
ppClientInterfaceInfo: Pointer; // BYTE** optional, out
lpdwClientInterfaceInfoSize: Pointer // DWORD* optional, out
): DWORD; stdcall;
external 'MPRAPI.dll' name 'MprAdminTransportGetInfo';result := DllCall("MPRAPI\MprAdminTransportGetInfo"
, "Ptr", hMprServer ; INT_PTR
, "UInt", dwTransportId ; DWORD
, "Ptr", ppGlobalInfo ; BYTE** optional, out
, "Ptr", lpdwGlobalInfoSize ; DWORD* optional, out
, "Ptr", ppClientInterfaceInfo ; BYTE** optional, out
, "Ptr", lpdwClientInterfaceInfoSize ; DWORD* optional, out
, "UInt") ; return: DWORD●MprAdminTransportGetInfo(hMprServer, dwTransportId, ppGlobalInfo, lpdwGlobalInfoSize, ppClientInterfaceInfo, lpdwClientInterfaceInfoSize) = DLL("MPRAPI.dll", "dword MprAdminTransportGetInfo(int, dword, void*, void*, void*, void*)")
# 呼び出し: MprAdminTransportGetInfo(hMprServer, dwTransportId, ppGlobalInfo, lpdwGlobalInfoSize, ppClientInterfaceInfo, lpdwClientInterfaceInfoSize)
# hMprServer : INT_PTR -> "int"
# dwTransportId : DWORD -> "dword"
# ppGlobalInfo : BYTE** optional, out -> "void*"
# lpdwGlobalInfoSize : DWORD* optional, out -> "void*"
# ppClientInterfaceInfo : BYTE** optional, out -> "void*"
# lpdwClientInterfaceInfoSize : DWORD* optional, out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。