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

RASCONNSTATUSW

構造体
サイズx64: 624 バイト / x86: 608 バイト

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

フィールド

フィールドサイズx64x86説明
dwSizeDWORD4+0+0この構造体のバイト単位のサイズ。呼び出し前にsizeofを設定する。
rasconnstateRASCONNSTATE4+4+4接続の現在の状態を表すRASCONNSTATE列挙値。接続済みや切断中など。
dwErrorDWORD4+8+8状態遷移中に発生したエラーコード。0なら正常。
szDeviceTypeWCHAR34+12+12接続に使用中のデバイス種別を表すワイド文字列。
szDeviceNameWCHAR258+46+46接続に使用中のデバイス名を表すワイド文字列。
szPhoneNumberWCHAR258+304+304接続で実際にダイヤルされた電話番号のワイド文字列。
localEndPointRASTUNNELENDPOINT24/20+568+564VPNトンネルのローカル側エンドポイントアドレス情報。
remoteEndPointRASTUNNELENDPOINT24/20+592+584VPNトンネルのリモート側エンドポイントアドレス情報。
rasconnsubstateRASCONNSUBSTATE4+616+604接続のサブ状態を表すRASCONNSUBSTATE列挙値。より詳細な進行状況。

各言語での定義

#include <windows.h>

// RASTUNNELENDPOINT  (x64 24 / x86 20 バイト)
typedef struct RASTUNNELENDPOINT {
    DWORD dwType;
    _Anonymous_e__Union Anonymous;
} RASTUNNELENDPOINT;

// RASCONNSTATUSW  (x64 624 / x86 608 バイト)
typedef struct RASCONNSTATUSW {
    DWORD dwSize;
    RASCONNSTATE rasconnstate;
    DWORD dwError;
    WCHAR szDeviceType[17];
    WCHAR szDeviceName[129];
    WCHAR szPhoneNumber[129];
    RASTUNNELENDPOINT localEndPoint;
    RASTUNNELENDPOINT remoteEndPoint;
    RASCONNSUBSTATE rasconnsubstate;
} RASCONNSTATUSW;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct RASTUNNELENDPOINT
{
    public uint dwType;
    public _Anonymous_e__Union Anonymous;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct RASCONNSTATUSW
{
    public uint dwSize;
    public int rasconnstate;
    public uint dwError;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 17)] public string szDeviceType;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 129)] public string szDeviceName;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 129)] public string szPhoneNumber;
    public RASTUNNELENDPOINT localEndPoint;
    public RASTUNNELENDPOINT remoteEndPoint;
    public int rasconnsubstate;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure RASTUNNELENDPOINT
    Public dwType As UInteger
    Public Anonymous As _Anonymous_e__Union
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure RASCONNSTATUSW
    Public dwSize As UInteger
    Public rasconnstate As Integer
    Public dwError As UInteger
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=17)> Public szDeviceType As String
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=129)> Public szDeviceName As String
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=129)> Public szPhoneNumber As String
    Public localEndPoint As RASTUNNELENDPOINT
    Public remoteEndPoint As RASTUNNELENDPOINT
    Public rasconnsubstate As Integer
End Structure
import ctypes
from ctypes import wintypes

class RASTUNNELENDPOINT(ctypes.Structure):
    _fields_ = [
        ("dwType", wintypes.DWORD),
        ("Anonymous", _Anonymous_e__Union),
    ]

class RASCONNSTATUSW(ctypes.Structure):
    _fields_ = [
        ("dwSize", wintypes.DWORD),
        ("rasconnstate", ctypes.c_int),
        ("dwError", wintypes.DWORD),
        ("szDeviceType", ctypes.c_wchar * 17),
        ("szDeviceName", ctypes.c_wchar * 129),
        ("szPhoneNumber", ctypes.c_wchar * 129),
        ("localEndPoint", RASTUNNELENDPOINT),
        ("remoteEndPoint", RASTUNNELENDPOINT),
        ("rasconnsubstate", ctypes.c_int),
    ]
#[repr(C)]
pub struct RASTUNNELENDPOINT {
    pub dwType: u32,
    pub Anonymous: _Anonymous_e__Union,
}

#[repr(C)]
pub struct RASCONNSTATUSW {
    pub dwSize: u32,
    pub rasconnstate: i32,
    pub dwError: u32,
    pub szDeviceType: [u16; 17],
    pub szDeviceName: [u16; 129],
    pub szPhoneNumber: [u16; 129],
    pub localEndPoint: RASTUNNELENDPOINT,
    pub remoteEndPoint: RASTUNNELENDPOINT,
    pub rasconnsubstate: i32,
}
import "golang.org/x/sys/windows"

type RASTUNNELENDPOINT struct {
	dwType uint32
	Anonymous _Anonymous_e__Union
}

type RASCONNSTATUSW struct {
	dwSize uint32
	rasconnstate int32
	dwError uint32
	szDeviceType [17]uint16
	szDeviceName [129]uint16
	szPhoneNumber [129]uint16
	localEndPoint RASTUNNELENDPOINT
	remoteEndPoint RASTUNNELENDPOINT
	rasconnsubstate int32
}
type
  RASTUNNELENDPOINT = record
    dwType: DWORD;
    Anonymous: _Anonymous_e__Union;
  end;

  RASCONNSTATUSW = record
    dwSize: DWORD;
    rasconnstate: Integer;
    dwError: DWORD;
    szDeviceType: array[0..16] of WideChar;
    szDeviceName: array[0..128] of WideChar;
    szPhoneNumber: array[0..128] of WideChar;
    localEndPoint: RASTUNNELENDPOINT;
    remoteEndPoint: RASTUNNELENDPOINT;
    rasconnsubstate: Integer;
  end;
const RASTUNNELENDPOINT = extern struct {
    dwType: u32,
    Anonymous: _Anonymous_e__Union,
};

const RASCONNSTATUSW = extern struct {
    dwSize: u32,
    rasconnstate: i32,
    dwError: u32,
    szDeviceType: [17]u16,
    szDeviceName: [129]u16,
    szPhoneNumber: [129]u16,
    localEndPoint: RASTUNNELENDPOINT,
    remoteEndPoint: RASTUNNELENDPOINT,
    rasconnsubstate: i32,
};
type
  RASTUNNELENDPOINT {.bycopy.} = object
    dwType: uint32
    Anonymous: _Anonymous_e__Union

  RASCONNSTATUSW {.bycopy.} = object
    dwSize: uint32
    rasconnstate: int32
    dwError: uint32
    szDeviceType: array[17, uint16]
    szDeviceName: array[129, uint16]
    szPhoneNumber: array[129, uint16]
    localEndPoint: RASTUNNELENDPOINT
    remoteEndPoint: RASTUNNELENDPOINT
    rasconnsubstate: int32
struct RASTUNNELENDPOINT
{
    uint dwType;
    _Anonymous_e__Union Anonymous;
}

struct RASCONNSTATUSW
{
    uint dwSize;
    int rasconnstate;
    uint dwError;
    wchar[17] szDeviceType;
    wchar[129] szDeviceName;
    wchar[129] szPhoneNumber;
    RASTUNNELENDPOINT localEndPoint;
    RASTUNNELENDPOINT remoteEndPoint;
    int rasconnsubstate;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; RASCONNSTATUSW サイズ: 608 バイト(x86)
dim st, 152    ; 4byte整数×152(構造体サイズ 608 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; rasconnstate : RASCONNSTATE (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; dwError : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; szDeviceType : WCHAR (+12, 34byte)  varptr(st)+12 を基点に操作(34byte:入れ子/配列)
; szDeviceName : WCHAR (+46, 258byte)  varptr(st)+46 を基点に操作(258byte:入れ子/配列)
; szPhoneNumber : WCHAR (+304, 258byte)  varptr(st)+304 を基点に操作(258byte:入れ子/配列)
; localEndPoint : RASTUNNELENDPOINT (+564, 20byte)  varptr(st)+564 を基点に操作(20byte:入れ子/配列)
; remoteEndPoint : RASTUNNELENDPOINT (+584, 20byte)  varptr(st)+584 を基点に操作(20byte:入れ子/配列)
; rasconnsubstate : RASCONNSUBSTATE (+604, 4byte)  st.151 = 値  /  値 = st.151   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; RASCONNSTATUSW サイズ: 624 バイト(x64)
dim st, 156    ; 4byte整数×156(構造体サイズ 624 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; rasconnstate : RASCONNSTATE (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; dwError : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; szDeviceType : WCHAR (+12, 34byte)  varptr(st)+12 を基点に操作(34byte:入れ子/配列)
; szDeviceName : WCHAR (+46, 258byte)  varptr(st)+46 を基点に操作(258byte:入れ子/配列)
; szPhoneNumber : WCHAR (+304, 258byte)  varptr(st)+304 を基点に操作(258byte:入れ子/配列)
; localEndPoint : RASTUNNELENDPOINT (+568, 24byte)  varptr(st)+568 を基点に操作(24byte:入れ子/配列)
; remoteEndPoint : RASTUNNELENDPOINT (+592, 24byte)  varptr(st)+592 を基点に操作(24byte:入れ子/配列)
; rasconnsubstate : RASCONNSUBSTATE (+616, 4byte)  st.154 = 値  /  値 = st.154   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global RASTUNNELENDPOINT
    #field int dwType
    #field byte Anonymous 16
#endstruct

#defstruct global RASCONNSTATUSW
    #field int dwSize
    #field int rasconnstate
    #field int dwError
    #field wchar szDeviceType 17
    #field wchar szDeviceName 129
    #field wchar szPhoneNumber 129
    #field RASTUNNELENDPOINT localEndPoint
    #field RASTUNNELENDPOINT remoteEndPoint
    #field int rasconnsubstate
#endstruct

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