ホーム › NetworkManagement.Rras › MprAdminConnectionEnumEx

MprAdminConnectionEnumEx

関数

RASサーバー上の接続を拡張構造で列挙する。

DLLMPRAPI.dll呼出規約winapi対応OSWindows 7 以降

シグネチャ

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

DWORD MprAdminConnectionEnumEx(
    INT_PTR hRasServer,
    MPRAPI_OBJECT_HEADER* pObjectHeader,
    DWORD dwPreferedMaxLen,
    DWORD* lpdwEntriesRead,
    DWORD* lpdwTotalEntries,
    RAS_CONNECTION_EX** ppRasConn,
    DWORD* lpdwResumeHandle
);

パラメーター

名前	型	方向
hRasServer	INT_PTR	in
pObjectHeader	MPRAPI_OBJECT_HEADER*	in
dwPreferedMaxLen	DWORD	in
lpdwEntriesRead	DWORD*	out
lpdwTotalEntries	DWORD*	out
ppRasConn	RAS_CONNECTION_EX**	out
lpdwResumeHandle	DWORD*	in

戻り値の型: DWORD

各言語での呼び出し定義

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

DWORD MprAdminConnectionEnumEx(
    INT_PTR hRasServer,
    MPRAPI_OBJECT_HEADER* pObjectHeader,
    DWORD dwPreferedMaxLen,
    DWORD* lpdwEntriesRead,
    DWORD* lpdwTotalEntries,
    RAS_CONNECTION_EX** ppRasConn,
    DWORD* lpdwResumeHandle
);

[DllImport("MPRAPI.dll", ExactSpelling = true)]
static extern uint MprAdminConnectionEnumEx(
    IntPtr hRasServer,   // INT_PTR
    IntPtr pObjectHeader,   // MPRAPI_OBJECT_HEADER*
    uint dwPreferedMaxLen,   // DWORD
    out uint lpdwEntriesRead,   // DWORD* out
    out uint lpdwTotalEntries,   // DWORD* out
    IntPtr ppRasConn,   // RAS_CONNECTION_EX** out
    ref uint lpdwResumeHandle   // DWORD*
);

<DllImport("MPRAPI.dll", ExactSpelling:=True)>
Public Shared Function MprAdminConnectionEnumEx(
    hRasServer As IntPtr,   ' INT_PTR
    pObjectHeader As IntPtr,   ' MPRAPI_OBJECT_HEADER*
    dwPreferedMaxLen As UInteger,   ' DWORD
    <Out> ByRef lpdwEntriesRead As UInteger,   ' DWORD* out
    <Out> ByRef lpdwTotalEntries As UInteger,   ' DWORD* out
    ppRasConn As IntPtr,   ' RAS_CONNECTION_EX** out
    ByRef lpdwResumeHandle As UInteger   ' DWORD*
) As UInteger
End Function

' hRasServer : INT_PTR
' pObjectHeader : MPRAPI_OBJECT_HEADER*
' dwPreferedMaxLen : DWORD
' lpdwEntriesRead : DWORD* out
' lpdwTotalEntries : DWORD* out
' ppRasConn : RAS_CONNECTION_EX** out
' lpdwResumeHandle : DWORD*
Declare PtrSafe Function MprAdminConnectionEnumEx Lib "mprapi" ( _
    ByVal hRasServer As LongPtr, _
    ByVal pObjectHeader As LongPtr, _
    ByVal dwPreferedMaxLen As Long, _
    ByRef lpdwEntriesRead As Long, _
    ByRef lpdwTotalEntries As Long, _
    ByVal ppRasConn As LongPtr, _
    ByRef lpdwResumeHandle As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

MprAdminConnectionEnumEx = ctypes.windll.mprapi.MprAdminConnectionEnumEx
MprAdminConnectionEnumEx.restype = wintypes.DWORD
MprAdminConnectionEnumEx.argtypes = [
    ctypes.c_ssize_t,  # hRasServer : INT_PTR
    ctypes.c_void_p,  # pObjectHeader : MPRAPI_OBJECT_HEADER*
    wintypes.DWORD,  # dwPreferedMaxLen : DWORD
    ctypes.POINTER(wintypes.DWORD),  # lpdwEntriesRead : DWORD* out
    ctypes.POINTER(wintypes.DWORD),  # lpdwTotalEntries : DWORD* out
    ctypes.c_void_p,  # ppRasConn : RAS_CONNECTION_EX** out
    ctypes.POINTER(wintypes.DWORD),  # lpdwResumeHandle : DWORD*
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('MPRAPI.dll')
MprAdminConnectionEnumEx = Fiddle::Function.new(
  lib['MprAdminConnectionEnumEx'],
  [
    Fiddle::TYPE_INTPTR_T,  # hRasServer : INT_PTR
    Fiddle::TYPE_VOIDP,  # pObjectHeader : MPRAPI_OBJECT_HEADER*
    -Fiddle::TYPE_INT,  # dwPreferedMaxLen : DWORD
    Fiddle::TYPE_VOIDP,  # lpdwEntriesRead : DWORD* out
    Fiddle::TYPE_VOIDP,  # lpdwTotalEntries : DWORD* out
    Fiddle::TYPE_VOIDP,  # ppRasConn : RAS_CONNECTION_EX** out
    Fiddle::TYPE_VOIDP,  # lpdwResumeHandle : DWORD*
  ],
  -Fiddle::TYPE_INT)

#[link(name = "mprapi")]
extern "system" {
    fn MprAdminConnectionEnumEx(
        hRasServer: isize,  // INT_PTR
        pObjectHeader: *mut MPRAPI_OBJECT_HEADER,  // MPRAPI_OBJECT_HEADER*
        dwPreferedMaxLen: u32,  // DWORD
        lpdwEntriesRead: *mut u32,  // DWORD* out
        lpdwTotalEntries: *mut u32,  // DWORD* out
        ppRasConn: *mut *mut RAS_CONNECTION_EX,  // RAS_CONNECTION_EX** out
        lpdwResumeHandle: *mut u32  // DWORD*
    ) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("MPRAPI.dll")]
public static extern uint MprAdminConnectionEnumEx(IntPtr hRasServer, IntPtr pObjectHeader, uint dwPreferedMaxLen, out uint lpdwEntriesRead, out uint lpdwTotalEntries, IntPtr ppRasConn, ref uint lpdwResumeHandle);
"@
$api = Add-Type -MemberDefinition $sig -Name 'MPRAPI_MprAdminConnectionEnumEx' -Namespace Win32 -PassThru
# $api::MprAdminConnectionEnumEx(hRasServer, pObjectHeader, dwPreferedMaxLen, lpdwEntriesRead, lpdwTotalEntries, ppRasConn, lpdwResumeHandle)

#uselib "MPRAPI.dll"
#func global MprAdminConnectionEnumEx "MprAdminConnectionEnumEx" sptr, sptr, sptr, sptr, sptr, sptr, sptr
; MprAdminConnectionEnumEx hRasServer, varptr(pObjectHeader), dwPreferedMaxLen, varptr(lpdwEntriesRead), varptr(lpdwTotalEntries), varptr(ppRasConn), varptr(lpdwResumeHandle)   ; 戻り値は stat
; hRasServer : INT_PTR -> "sptr"
; pObjectHeader : MPRAPI_OBJECT_HEADER* -> "sptr"
; dwPreferedMaxLen : DWORD -> "sptr"
; lpdwEntriesRead : DWORD* out -> "sptr"
; lpdwTotalEntries : DWORD* out -> "sptr"
; ppRasConn : RAS_CONNECTION_EX** out -> "sptr"
; lpdwResumeHandle : DWORD* -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "MPRAPI.dll"
#cfunc global MprAdminConnectionEnumEx "MprAdminConnectionEnumEx" sptr, var, int, var, var, var, var
; res = MprAdminConnectionEnumEx(hRasServer, pObjectHeader, dwPreferedMaxLen, lpdwEntriesRead, lpdwTotalEntries, ppRasConn, lpdwResumeHandle)
; hRasServer : INT_PTR -> "sptr"
; pObjectHeader : MPRAPI_OBJECT_HEADER* -> "var"
; dwPreferedMaxLen : DWORD -> "int"
; lpdwEntriesRead : DWORD* out -> "var"
; lpdwTotalEntries : DWORD* out -> "var"
; ppRasConn : RAS_CONNECTION_EX** out -> "var"
; lpdwResumeHandle : DWORD* -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "MPRAPI.dll"
#cfunc global MprAdminConnectionEnumEx "MprAdminConnectionEnumEx" sptr, sptr, int, sptr, sptr, sptr, sptr
; res = MprAdminConnectionEnumEx(hRasServer, varptr(pObjectHeader), dwPreferedMaxLen, varptr(lpdwEntriesRead), varptr(lpdwTotalEntries), varptr(ppRasConn), varptr(lpdwResumeHandle))
; hRasServer : INT_PTR -> "sptr"
; pObjectHeader : MPRAPI_OBJECT_HEADER* -> "sptr"
; dwPreferedMaxLen : DWORD -> "int"
; lpdwEntriesRead : DWORD* out -> "sptr"
; lpdwTotalEntries : DWORD* out -> "sptr"
; ppRasConn : RAS_CONNECTION_EX** out -> "sptr"
; lpdwResumeHandle : DWORD* -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。

出力引数:

; DWORD MprAdminConnectionEnumEx(INT_PTR hRasServer, MPRAPI_OBJECT_HEADER* pObjectHeader, DWORD dwPreferedMaxLen, DWORD* lpdwEntriesRead, DWORD* lpdwTotalEntries, RAS_CONNECTION_EX** ppRasConn, DWORD* lpdwResumeHandle)
#uselib "MPRAPI.dll"
#cfunc global MprAdminConnectionEnumEx "MprAdminConnectionEnumEx" intptr, var, int, var, var, var, var
; res = MprAdminConnectionEnumEx(hRasServer, pObjectHeader, dwPreferedMaxLen, lpdwEntriesRead, lpdwTotalEntries, ppRasConn, lpdwResumeHandle)
; hRasServer : INT_PTR -> "intptr"
; pObjectHeader : MPRAPI_OBJECT_HEADER* -> "var"
; dwPreferedMaxLen : DWORD -> "int"
; lpdwEntriesRead : DWORD* out -> "var"
; lpdwTotalEntries : DWORD* out -> "var"
; ppRasConn : RAS_CONNECTION_EX** out -> "var"
; lpdwResumeHandle : DWORD* -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; DWORD MprAdminConnectionEnumEx(INT_PTR hRasServer, MPRAPI_OBJECT_HEADER* pObjectHeader, DWORD dwPreferedMaxLen, DWORD* lpdwEntriesRead, DWORD* lpdwTotalEntries, RAS_CONNECTION_EX** ppRasConn, DWORD* lpdwResumeHandle)
#uselib "MPRAPI.dll"
#cfunc global MprAdminConnectionEnumEx "MprAdminConnectionEnumEx" intptr, intptr, int, intptr, intptr, intptr, intptr
; res = MprAdminConnectionEnumEx(hRasServer, varptr(pObjectHeader), dwPreferedMaxLen, varptr(lpdwEntriesRead), varptr(lpdwTotalEntries), varptr(ppRasConn), varptr(lpdwResumeHandle))
; hRasServer : INT_PTR -> "intptr"
; pObjectHeader : MPRAPI_OBJECT_HEADER* -> "intptr"
; dwPreferedMaxLen : DWORD -> "int"
; lpdwEntriesRead : DWORD* out -> "intptr"
; lpdwTotalEntries : DWORD* out -> "intptr"
; ppRasConn : RAS_CONNECTION_EX** out -> "intptr"
; lpdwResumeHandle : DWORD* -> "intptr"
; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。

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

var (
	mprapi = windows.NewLazySystemDLL("MPRAPI.dll")
	procMprAdminConnectionEnumEx = mprapi.NewProc("MprAdminConnectionEnumEx")
)

// hRasServer (INT_PTR), pObjectHeader (MPRAPI_OBJECT_HEADER*), dwPreferedMaxLen (DWORD), lpdwEntriesRead (DWORD* out), lpdwTotalEntries (DWORD* out), ppRasConn (RAS_CONNECTION_EX** out), lpdwResumeHandle (DWORD*)
r1, _, err := procMprAdminConnectionEnumEx.Call(
	uintptr(hRasServer),
	uintptr(pObjectHeader),
	uintptr(dwPreferedMaxLen),
	uintptr(lpdwEntriesRead),
	uintptr(lpdwTotalEntries),
	uintptr(ppRasConn),
	uintptr(lpdwResumeHandle),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // DWORD

function MprAdminConnectionEnumEx(
  hRasServer: NativeInt;   // INT_PTR
  pObjectHeader: Pointer;   // MPRAPI_OBJECT_HEADER*
  dwPreferedMaxLen: DWORD;   // DWORD
  lpdwEntriesRead: Pointer;   // DWORD* out
  lpdwTotalEntries: Pointer;   // DWORD* out
  ppRasConn: Pointer;   // RAS_CONNECTION_EX** out
  lpdwResumeHandle: Pointer   // DWORD*
): DWORD; stdcall;
  external 'MPRAPI.dll' name 'MprAdminConnectionEnumEx';

result := DllCall("MPRAPI\MprAdminConnectionEnumEx"
    , "Ptr", hRasServer   ; INT_PTR
    , "Ptr", pObjectHeader   ; MPRAPI_OBJECT_HEADER*
    , "UInt", dwPreferedMaxLen   ; DWORD
    , "Ptr", lpdwEntriesRead   ; DWORD* out
    , "Ptr", lpdwTotalEntries   ; DWORD* out
    , "Ptr", ppRasConn   ; RAS_CONNECTION_EX** out
    , "Ptr", lpdwResumeHandle   ; DWORD*
    , "UInt")   ; return: DWORD

●MprAdminConnectionEnumEx(hRasServer, pObjectHeader, dwPreferedMaxLen, lpdwEntriesRead, lpdwTotalEntries, ppRasConn, lpdwResumeHandle) = DLL("MPRAPI.dll", "dword MprAdminConnectionEnumEx(int, void*, dword, void*, void*, void*, void*)")
# 呼び出し: MprAdminConnectionEnumEx(hRasServer, pObjectHeader, dwPreferedMaxLen, lpdwEntriesRead, lpdwTotalEntries, ppRasConn, lpdwResumeHandle)
# hRasServer : INT_PTR -> "int"
# pObjectHeader : MPRAPI_OBJECT_HEADER* -> "void*"
# dwPreferedMaxLen : DWORD -> "dword"
# lpdwEntriesRead : DWORD* out -> "void*"
# lpdwTotalEntries : DWORD* out -> "void*"
# ppRasConn : RAS_CONNECTION_EX** out -> "void*"
# lpdwResumeHandle : DWORD* -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。