Win32 API 日本語リファレンス
ホーム › NetworkManagement.Rras › MPR_SERVER_2

MPR_SERVER_2

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 24 バイト / x86: 24 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールド型サイズx64x86説明
dwNumPptpPortsDWORD4+0+0

デバイス上で PPTP 用に構成されているポート数を指定します。 dwNumPptpPorts の最大値を次の表に示します。値 0 は指定できません。

最大値 Windows のバージョン
1
 Windows Web Server 2008
1000
 Windows Server 2008 Standard
16,384
 Windows Server 2008 Datacenter および Windows Server 2008 Enterprise

dwNumPptpPorts に、サービス開始時にレジストリで構成された上限 (Windows Server 2008 Standard および Windows Server 2008 Enterprise では既定で 1000) を超える値が指定されている場合、MprConfigServerSetInfo 関数および MprAdminServerSetInfo 関数は ERROR_SUCCESS_REBOOT_REQUIRED を返します。

dwPptpPortFlagsDWORD4+4+4

デバイス上で RAS またはルーティングが有効かどうかを示すビットフラグのセットです。

値 意味
MPR_ENABLE_RAS_ON_DEVICE
 設定されている場合、デバイス上で RAS が有効です。
MPR_ENABLE_ROUTING_ON_DEVICE
 設定されている場合、デバイス上でルーティングが有効です。
dwNumL2tpPortsDWORD4+8+8

デバイス上で L2TP 用に構成されているポート数を指定します。 dwNumL2tpPorts の最大値を次の表に示します。値 0 は指定できません。

最大値 Windows のバージョン
1
 Windows Web Server 2008
1000
 Windows Server 2008 Standard
30,000
 Windows Server 2008 Datacenter および Windows Server 2008 Enterprise

dwNumL2tpPorts に、サービス開始時にレジストリで構成された上限 (Windows Server 2008 Standard および Windows Server 2008 Enterprise では既定で 1000) を超える値が指定されている場合、MprConfigServerSetInfo 関数および MprAdminServerSetInfo 関数は ERROR_SUCCESS_REBOOT_REQUIRED を返します。

dwL2tpPortFlagsDWORD4+12+12

デバイス上で RAS またはルーティングが有効かどうかを示すビットフラグのセットです。

値 意味
MPR_ENABLE_RAS_ON_DEVICE
 設定されている場合、デバイス上で RAS が有効です。
MPR_ENABLE_ROUTING_ON_DEVICE
 設定されている場合、デバイス上でルーティングが有効です。
dwNumSstpPortsDWORD4+16+16

デバイス上で SSTP 用に構成されているポート数を指定します。 dwNumSstpPorts の最大値を次の表に示します。値 0 は指定できません。

最大値 Windows のバージョン
1
 Windows Web Server 2008
1000
 Windows Server 2008 Standard
30,000
 Windows Server 2008 Datacenter および Windows Server 2008 Enterprise

dwNumSstpPorts に、サービス開始時にレジストリで構成された上限 (Windows Server 2008 Standard および Windows Server 2008 Enterprise では既定で 1000) を超える値が指定されている場合、MprConfigServerSetInfo 関数および MprAdminServerSetInfo 関数は ERROR_SUCCESS_REBOOT_REQUIRED を返します。

dwSstpPortFlagsDWORD4+20+20

デバイス上で RAS が有効かどうかを示すビットフラグのセットです。

値 意味
MPR_ENABLE_RAS_ON_DEVICE
 設定されている場合、デバイス上で RAS が有効です。

公式ドキュメント

MPR_SERVER_2 構造体は、デバイス上で Point-to-Point Tunneling Protocol (PPTP)、Layer 2 Tunneling Protocol (L2TP)、および Secure Socket Tunneling Protocol (SSTP) に利用できるポート数を取得および設定するために使用します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// MPR_SERVER_2  (x64 24 / x86 24 バイト)
typedef struct MPR_SERVER_2 {
    DWORD dwNumPptpPorts;
    DWORD dwPptpPortFlags;
    DWORD dwNumL2tpPorts;
    DWORD dwL2tpPortFlags;
    DWORD dwNumSstpPorts;
    DWORD dwSstpPortFlags;
} MPR_SERVER_2;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct MPR_SERVER_2
{
    public uint dwNumPptpPorts;
    public uint dwPptpPortFlags;
    public uint dwNumL2tpPorts;
    public uint dwL2tpPortFlags;
    public uint dwNumSstpPorts;
    public uint dwSstpPortFlags;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure MPR_SERVER_2
    Public dwNumPptpPorts As UInteger
    Public dwPptpPortFlags As UInteger
    Public dwNumL2tpPorts As UInteger
    Public dwL2tpPortFlags As UInteger
    Public dwNumSstpPorts As UInteger
    Public dwSstpPortFlags As UInteger
End Structure
import ctypes
from ctypes import wintypes

class MPR_SERVER_2(ctypes.Structure):
    _fields_ = [
        ("dwNumPptpPorts", wintypes.DWORD),
        ("dwPptpPortFlags", wintypes.DWORD),
        ("dwNumL2tpPorts", wintypes.DWORD),
        ("dwL2tpPortFlags", wintypes.DWORD),
        ("dwNumSstpPorts", wintypes.DWORD),
        ("dwSstpPortFlags", wintypes.DWORD),
    ]
#[repr(C)]
pub struct MPR_SERVER_2 {
    pub dwNumPptpPorts: u32,
    pub dwPptpPortFlags: u32,
    pub dwNumL2tpPorts: u32,
    pub dwL2tpPortFlags: u32,
    pub dwNumSstpPorts: u32,
    pub dwSstpPortFlags: u32,
}
import "golang.org/x/sys/windows"

type MPR_SERVER_2 struct {
	dwNumPptpPorts uint32
	dwPptpPortFlags uint32
	dwNumL2tpPorts uint32
	dwL2tpPortFlags uint32
	dwNumSstpPorts uint32
	dwSstpPortFlags uint32
}
type
  MPR_SERVER_2 = record
    dwNumPptpPorts: DWORD;
    dwPptpPortFlags: DWORD;
    dwNumL2tpPorts: DWORD;
    dwL2tpPortFlags: DWORD;
    dwNumSstpPorts: DWORD;
    dwSstpPortFlags: DWORD;
  end;
const MPR_SERVER_2 = extern struct {
    dwNumPptpPorts: u32,
    dwPptpPortFlags: u32,
    dwNumL2tpPorts: u32,
    dwL2tpPortFlags: u32,
    dwNumSstpPorts: u32,
    dwSstpPortFlags: u32,
};
type
  MPR_SERVER_2 {.bycopy.} = object
    dwNumPptpPorts: uint32
    dwPptpPortFlags: uint32
    dwNumL2tpPorts: uint32
    dwL2tpPortFlags: uint32
    dwNumSstpPorts: uint32
    dwSstpPortFlags: uint32
struct MPR_SERVER_2
{
    uint dwNumPptpPorts;
    uint dwPptpPortFlags;
    uint dwNumL2tpPorts;
    uint dwL2tpPortFlags;
    uint dwNumSstpPorts;
    uint dwSstpPortFlags;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; MPR_SERVER_2 サイズ: 24 バイト(x64)
dim st, 6    ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; dwNumPptpPorts : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwPptpPortFlags : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; dwNumL2tpPorts : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; dwL2tpPortFlags : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; dwNumSstpPorts : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; dwSstpPortFlags : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global MPR_SERVER_2
    #field int dwNumPptpPorts
    #field int dwPptpPortFlags
    #field int dwNumL2tpPorts
    #field int dwL2tpPortFlags
    #field int dwNumSstpPorts
    #field int dwSstpPortFlags
#endstruct

stdim st, MPR_SERVER_2        ; NSTRUCT 変数を確保
st->dwNumPptpPorts = 100
mes "dwNumPptpPorts=" + st->dwNumPptpPorts