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

RAS_UPDATE_CONNECTION

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

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

フィールド

フィールド型サイズx64x86説明
HeaderMPRAPI_OBJECT_HEADER4+0+0オブジェクトのリビジョン・種別・サイズを示すMPRAPI_OBJECT_HEADER。
dwIfIndexDWORD4+4+4更新対象接続のインターフェイスインデックス。
wszLocalEndpointAddressWCHAR130+8+8更新後のローカル側エンドポイントアドレス(ワイド文字列)。
wszRemoteEndpointAddressWCHAR130+138+138更新後のリモート側エンドポイントアドレス(ワイド文字列)。

各言語での定義

#include <windows.h>

// MPRAPI_OBJECT_HEADER  (x64 4 / x86 4 バイト)
typedef struct MPRAPI_OBJECT_HEADER {
    BYTE revision;
    BYTE type;
    WORD size;
} MPRAPI_OBJECT_HEADER;

// RAS_UPDATE_CONNECTION  (x64 268 / x86 268 バイト)
typedef struct RAS_UPDATE_CONNECTION {
    MPRAPI_OBJECT_HEADER Header;
    DWORD dwIfIndex;
    WCHAR wszLocalEndpointAddress[65];
    WCHAR wszRemoteEndpointAddress[65];
} RAS_UPDATE_CONNECTION;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct MPRAPI_OBJECT_HEADER
{
    public byte revision;
    public byte type;
    public ushort size;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct RAS_UPDATE_CONNECTION
{
    public MPRAPI_OBJECT_HEADER Header;
    public uint dwIfIndex;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 65)] public string wszLocalEndpointAddress;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 65)] public string wszRemoteEndpointAddress;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure MPRAPI_OBJECT_HEADER
    Public revision As Byte
    Public type As Byte
    Public size As UShort
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure RAS_UPDATE_CONNECTION
    Public Header As MPRAPI_OBJECT_HEADER
    Public dwIfIndex As UInteger
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=65)> Public wszLocalEndpointAddress As String
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=65)> Public wszRemoteEndpointAddress As String
End Structure
import ctypes
from ctypes import wintypes

class MPRAPI_OBJECT_HEADER(ctypes.Structure):
    _fields_ = [
        ("revision", ctypes.c_ubyte),
        ("type", ctypes.c_ubyte),
        ("size", ctypes.c_ushort),
    ]

class RAS_UPDATE_CONNECTION(ctypes.Structure):
    _fields_ = [
        ("Header", MPRAPI_OBJECT_HEADER),
        ("dwIfIndex", wintypes.DWORD),
        ("wszLocalEndpointAddress", ctypes.c_wchar * 65),
        ("wszRemoteEndpointAddress", ctypes.c_wchar * 65),
    ]
#[repr(C)]
pub struct MPRAPI_OBJECT_HEADER {
    pub revision: u8,
    pub type: u8,
    pub size: u16,
}

#[repr(C)]
pub struct RAS_UPDATE_CONNECTION {
    pub Header: MPRAPI_OBJECT_HEADER,
    pub dwIfIndex: u32,
    pub wszLocalEndpointAddress: [u16; 65],
    pub wszRemoteEndpointAddress: [u16; 65],
}
import "golang.org/x/sys/windows"

type MPRAPI_OBJECT_HEADER struct {
	revision byte
	type byte
	size uint16
}

type RAS_UPDATE_CONNECTION struct {
	Header MPRAPI_OBJECT_HEADER
	dwIfIndex uint32
	wszLocalEndpointAddress [65]uint16
	wszRemoteEndpointAddress [65]uint16
}
type
  MPRAPI_OBJECT_HEADER = record
    revision: Byte;
    type: Byte;
    size: Word;
  end;

  RAS_UPDATE_CONNECTION = record
    Header: MPRAPI_OBJECT_HEADER;
    dwIfIndex: DWORD;
    wszLocalEndpointAddress: array[0..64] of WideChar;
    wszRemoteEndpointAddress: array[0..64] of WideChar;
  end;
const MPRAPI_OBJECT_HEADER = extern struct {
    revision: u8,
    type: u8,
    size: u16,
};

const RAS_UPDATE_CONNECTION = extern struct {
    Header: MPRAPI_OBJECT_HEADER,
    dwIfIndex: u32,
    wszLocalEndpointAddress: [65]u16,
    wszRemoteEndpointAddress: [65]u16,
};
type
  MPRAPI_OBJECT_HEADER {.bycopy.} = object
    revision: uint8
    type: uint8
    size: uint16

  RAS_UPDATE_CONNECTION {.bycopy.} = object
    Header: MPRAPI_OBJECT_HEADER
    dwIfIndex: uint32
    wszLocalEndpointAddress: array[65, uint16]
    wszRemoteEndpointAddress: array[65, uint16]
struct MPRAPI_OBJECT_HEADER
{
    ubyte revision;
    ubyte type;
    ushort size;
}

struct RAS_UPDATE_CONNECTION
{
    MPRAPI_OBJECT_HEADER Header;
    uint dwIfIndex;
    wchar[65] wszLocalEndpointAddress;
    wchar[65] wszRemoteEndpointAddress;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; RAS_UPDATE_CONNECTION サイズ: 268 バイト(x64)
dim st, 67    ; 4byte整数×67(構造体サイズ 268 / 4 切り上げ)
; Header : MPRAPI_OBJECT_HEADER (+0, 4byte)  varptr(st)+0 を基点に操作(4byte:入れ子/配列)
; dwIfIndex : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; wszLocalEndpointAddress : WCHAR (+8, 130byte)  varptr(st)+8 を基点に操作(130byte:入れ子/配列)
; wszRemoteEndpointAddress : WCHAR (+138, 130byte)  varptr(st)+138 を基点に操作(130byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global MPRAPI_OBJECT_HEADER
    #field byte revision
    #field byte type
    #field short size
#endstruct

#defstruct global RAS_UPDATE_CONNECTION
    #field MPRAPI_OBJECT_HEADER Header
    #field int dwIfIndex
    #field wchar wszLocalEndpointAddress 65
    #field wchar wszRemoteEndpointAddress 65
#endstruct

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