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

RASCONNW

構造体
サイズx64: 1392 バイト / x86: 1384 バイト

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

フィールド

フィールドサイズx64x86説明
dwSizeDWORD4+0+0この構造体のサイズをバイト単位で示す値。呼び出し前に設定する。
hrasconnHRASCONN8/4+8+4RAS接続を識別するハンドル(HRASCONN)。
szEntryNameWCHAR514+16+8接続に使用したフォンブックエントリ名を格納するワイド文字配列。
szDeviceTypeWCHAR34+530+522接続デバイスの種別を格納するワイド文字配列。
szDeviceNameWCHAR258+564+556接続デバイス名を格納するワイド文字配列。
szPhonebookWCHAR520+822+814使用したフォンブックのフルパスを格納するワイド文字配列。
dwSubEntryDWORD4+1344+1336マルチリンク接続のサブエントリ番号。
guidEntryGUID16+1348+1340フォンブックエントリを識別するGUID。
dwFlagsDWORD4+1364+1356接続の状態を示すフラグ。
luidLUID8+1368+1360接続のログオンセッションを識別するLUID。
guidCorrelationIdGUID16+1376+1368接続を相関付けるためのGUID。

各言語での定義

#include <windows.h>

// LUID  (x64 8 / x86 8 バイト)
typedef struct LUID {
    DWORD LowPart;
    INT HighPart;
} LUID;

// RASCONNW  (x64 1392 / x86 1384 バイト)
typedef struct RASCONNW {
    DWORD dwSize;
    HRASCONN hrasconn;
    WCHAR szEntryName[257];
    WCHAR szDeviceType[17];
    WCHAR szDeviceName[129];
    WCHAR szPhonebook[260];
    DWORD dwSubEntry;
    GUID guidEntry;
    DWORD dwFlags;
    LUID luid;
    GUID guidCorrelationId;
} RASCONNW;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct LUID
{
    public uint LowPart;
    public int HighPart;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct RASCONNW
{
    public uint dwSize;
    public IntPtr hrasconn;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 257)] public string szEntryName;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 17)] public string szDeviceType;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 129)] public string szDeviceName;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 260)] public string szPhonebook;
    public uint dwSubEntry;
    public Guid guidEntry;
    public uint dwFlags;
    public LUID luid;
    public Guid guidCorrelationId;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure LUID
    Public LowPart As UInteger
    Public HighPart As Integer
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure RASCONNW
    Public dwSize As UInteger
    Public hrasconn As IntPtr
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=257)> Public szEntryName As String
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=17)> Public szDeviceType As String
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=129)> Public szDeviceName As String
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=260)> Public szPhonebook As String
    Public dwSubEntry As UInteger
    Public guidEntry As Guid
    Public dwFlags As UInteger
    Public luid As LUID
    Public guidCorrelationId As Guid
End Structure
import ctypes
from ctypes import wintypes

class LUID(ctypes.Structure):
    _fields_ = [
        ("LowPart", wintypes.DWORD),
        ("HighPart", ctypes.c_int),
    ]

class RASCONNW(ctypes.Structure):
    _fields_ = [
        ("dwSize", wintypes.DWORD),
        ("hrasconn", ctypes.c_void_p),
        ("szEntryName", ctypes.c_wchar * 257),
        ("szDeviceType", ctypes.c_wchar * 17),
        ("szDeviceName", ctypes.c_wchar * 129),
        ("szPhonebook", ctypes.c_wchar * 260),
        ("dwSubEntry", wintypes.DWORD),
        ("guidEntry", GUID),
        ("dwFlags", wintypes.DWORD),
        ("luid", LUID),
        ("guidCorrelationId", GUID),
    ]
#[repr(C)]
pub struct LUID {
    pub LowPart: u32,
    pub HighPart: i32,
}

#[repr(C)]
pub struct RASCONNW {
    pub dwSize: u32,
    pub hrasconn: *mut core::ffi::c_void,
    pub szEntryName: [u16; 257],
    pub szDeviceType: [u16; 17],
    pub szDeviceName: [u16; 129],
    pub szPhonebook: [u16; 260],
    pub dwSubEntry: u32,
    pub guidEntry: GUID,
    pub dwFlags: u32,
    pub luid: LUID,
    pub guidCorrelationId: GUID,
}
import "golang.org/x/sys/windows"

type LUID struct {
	LowPart uint32
	HighPart int32
}

type RASCONNW struct {
	dwSize uint32
	hrasconn uintptr
	szEntryName [257]uint16
	szDeviceType [17]uint16
	szDeviceName [129]uint16
	szPhonebook [260]uint16
	dwSubEntry uint32
	guidEntry windows.GUID
	dwFlags uint32
	luid LUID
	guidCorrelationId windows.GUID
}
type
  LUID = record
    LowPart: DWORD;
    HighPart: Integer;
  end;

  RASCONNW = record
    dwSize: DWORD;
    hrasconn: Pointer;
    szEntryName: array[0..256] of WideChar;
    szDeviceType: array[0..16] of WideChar;
    szDeviceName: array[0..128] of WideChar;
    szPhonebook: array[0..259] of WideChar;
    dwSubEntry: DWORD;
    guidEntry: TGUID;
    dwFlags: DWORD;
    luid: LUID;
    guidCorrelationId: TGUID;
  end;
const LUID = extern struct {
    LowPart: u32,
    HighPart: i32,
};

const RASCONNW = extern struct {
    dwSize: u32,
    hrasconn: ?*anyopaque,
    szEntryName: [257]u16,
    szDeviceType: [17]u16,
    szDeviceName: [129]u16,
    szPhonebook: [260]u16,
    dwSubEntry: u32,
    guidEntry: GUID,
    dwFlags: u32,
    luid: LUID,
    guidCorrelationId: GUID,
};
type
  LUID {.bycopy.} = object
    LowPart: uint32
    HighPart: int32

  RASCONNW {.bycopy.} = object
    dwSize: uint32
    hrasconn: pointer
    szEntryName: array[257, uint16]
    szDeviceType: array[17, uint16]
    szDeviceName: array[129, uint16]
    szPhonebook: array[260, uint16]
    dwSubEntry: uint32
    guidEntry: GUID
    dwFlags: uint32
    luid: LUID
    guidCorrelationId: GUID
struct LUID
{
    uint LowPart;
    int HighPart;
}

struct RASCONNW
{
    uint dwSize;
    void* hrasconn;
    wchar[257] szEntryName;
    wchar[17] szDeviceType;
    wchar[129] szDeviceName;
    wchar[260] szPhonebook;
    uint dwSubEntry;
    GUID guidEntry;
    uint dwFlags;
    LUID luid;
    GUID guidCorrelationId;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; RASCONNW サイズ: 1384 バイト(x86)
dim st, 346    ; 4byte整数×346(構造体サイズ 1384 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; hrasconn : HRASCONN (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; szEntryName : WCHAR (+8, 514byte)  varptr(st)+8 を基点に操作(514byte:入れ子/配列)
; szDeviceType : WCHAR (+522, 34byte)  varptr(st)+522 を基点に操作(34byte:入れ子/配列)
; szDeviceName : WCHAR (+556, 258byte)  varptr(st)+556 を基点に操作(258byte:入れ子/配列)
; szPhonebook : WCHAR (+814, 520byte)  varptr(st)+814 を基点に操作(520byte:入れ子/配列)
; dwSubEntry : DWORD (+1336, 4byte)  st.334 = 値  /  値 = st.334   (lpoke/lpeek も可)
; guidEntry : GUID (+1340, 16byte)  varptr(st)+1340 を基点に操作(16byte:入れ子/配列)
; dwFlags : DWORD (+1356, 4byte)  st.339 = 値  /  値 = st.339   (lpoke/lpeek も可)
; luid : LUID (+1360, 8byte)  varptr(st)+1360 を基点に操作(8byte:入れ子/配列)
; guidCorrelationId : GUID (+1368, 16byte)  varptr(st)+1368 を基点に操作(16byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; RASCONNW サイズ: 1392 バイト(x64)
dim st, 348    ; 4byte整数×348(構造体サイズ 1392 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; hrasconn : HRASCONN (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; szEntryName : WCHAR (+16, 514byte)  varptr(st)+16 を基点に操作(514byte:入れ子/配列)
; szDeviceType : WCHAR (+530, 34byte)  varptr(st)+530 を基点に操作(34byte:入れ子/配列)
; szDeviceName : WCHAR (+564, 258byte)  varptr(st)+564 を基点に操作(258byte:入れ子/配列)
; szPhonebook : WCHAR (+822, 520byte)  varptr(st)+822 を基点に操作(520byte:入れ子/配列)
; dwSubEntry : DWORD (+1344, 4byte)  st.336 = 値  /  値 = st.336   (lpoke/lpeek も可)
; guidEntry : GUID (+1348, 16byte)  varptr(st)+1348 を基点に操作(16byte:入れ子/配列)
; dwFlags : DWORD (+1364, 4byte)  st.341 = 値  /  値 = st.341   (lpoke/lpeek も可)
; luid : LUID (+1368, 8byte)  varptr(st)+1368 を基点に操作(8byte:入れ子/配列)
; guidCorrelationId : GUID (+1376, 16byte)  varptr(st)+1376 を基点に操作(16byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global GUID, pack=1
    #field int Data1
    #field short Data2
    #field short Data3
    #field byte Data4 8
#endstruct

#defstruct global LUID
    #field int LowPart
    #field int HighPart
#endstruct

#defstruct global RASCONNW
    #field int dwSize
    #field intptr hrasconn
    #field wchar szEntryName 257
    #field wchar szDeviceType 17
    #field wchar szDeviceName 129
    #field wchar szPhonebook 260
    #field int dwSubEntry
    #field GUID guidEntry
    #field int dwFlags
    #field LUID luid
    #field GUID guidCorrelationId
#endstruct

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