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

RASDIALPARAMSA

構造体
サイズx64: 1080 バイト / x86: 1068 バイト

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

フィールド

フィールドサイズx64x86説明
dwSizeDWORD4+0+0この構造体のバイト単位のサイズ。呼び出し前にsizeofを設定する。
szEntryNameCHAR257+4+4ダイヤルに使用する電話帳エントリ名のANSI文字列。
szPhoneNumberCHAR129+261+261エントリの番号を上書きする電話番号。空なら電話帳の値を使う。
szCallbackNumberCHAR129+390+390コールバック機能でサーバーが折り返す電話番号のANSI文字列。
szUserNameCHAR257+519+519認証に使用するユーザー名のANSI文字列。
szPasswordCHAR257+776+776認証に使用するパスワードのANSI文字列。
szDomainCHAR16+1033+1033認証に使用するドメイン名のANSI文字列。
dwSubEntryDWORD4+1052+1052ダイヤルするサブエントリの1基点インデックス。
dwCallbackIdUINT_PTR8/4+1056+1056コールバック関数に渡されるアプリ定義の値。
dwIfIndexDWORD4+1064+1060接続に関連付けるインターフェイスのインデックス。
szEncPasswordLPSTR8/4+1072+1064暗号化されたパスワードへのポインタ。NULL可。

各言語での定義

#include <windows.h>

// RASDIALPARAMSA  (x64 1080 / x86 1068 バイト)
typedef struct RASDIALPARAMSA {
    DWORD dwSize;
    CHAR szEntryName[257];
    CHAR szPhoneNumber[129];
    CHAR szCallbackNumber[129];
    CHAR szUserName[257];
    CHAR szPassword[257];
    CHAR szDomain[16];
    DWORD dwSubEntry;
    UINT_PTR dwCallbackId;
    DWORD dwIfIndex;
    LPSTR szEncPassword;
} RASDIALPARAMSA;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct RASDIALPARAMSA
{
    public uint dwSize;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 257)] public sbyte[] szEntryName;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 129)] public sbyte[] szPhoneNumber;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 129)] public sbyte[] szCallbackNumber;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 257)] public sbyte[] szUserName;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 257)] public sbyte[] szPassword;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 16)] public sbyte[] szDomain;
    public uint dwSubEntry;
    public UIntPtr dwCallbackId;
    public uint dwIfIndex;
    public IntPtr szEncPassword;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure RASDIALPARAMSA
    Public dwSize As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=257)> Public szEntryName() As SByte
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=129)> Public szPhoneNumber() As SByte
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=129)> Public szCallbackNumber() As SByte
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=257)> Public szUserName() As SByte
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=257)> Public szPassword() As SByte
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=16)> Public szDomain() As SByte
    Public dwSubEntry As UInteger
    Public dwCallbackId As UIntPtr
    Public dwIfIndex As UInteger
    Public szEncPassword As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class RASDIALPARAMSA(ctypes.Structure):
    _fields_ = [
        ("dwSize", wintypes.DWORD),
        ("szEntryName", ctypes.c_byte * 257),
        ("szPhoneNumber", ctypes.c_byte * 129),
        ("szCallbackNumber", ctypes.c_byte * 129),
        ("szUserName", ctypes.c_byte * 257),
        ("szPassword", ctypes.c_byte * 257),
        ("szDomain", ctypes.c_byte * 16),
        ("dwSubEntry", wintypes.DWORD),
        ("dwCallbackId", ctypes.c_size_t),
        ("dwIfIndex", wintypes.DWORD),
        ("szEncPassword", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct RASDIALPARAMSA {
    pub dwSize: u32,
    pub szEntryName: [i8; 257],
    pub szPhoneNumber: [i8; 129],
    pub szCallbackNumber: [i8; 129],
    pub szUserName: [i8; 257],
    pub szPassword: [i8; 257],
    pub szDomain: [i8; 16],
    pub dwSubEntry: u32,
    pub dwCallbackId: usize,
    pub dwIfIndex: u32,
    pub szEncPassword: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type RASDIALPARAMSA struct {
	dwSize uint32
	szEntryName [257]int8
	szPhoneNumber [129]int8
	szCallbackNumber [129]int8
	szUserName [257]int8
	szPassword [257]int8
	szDomain [16]int8
	dwSubEntry uint32
	dwCallbackId uintptr
	dwIfIndex uint32
	szEncPassword uintptr
}
type
  RASDIALPARAMSA = record
    dwSize: DWORD;
    szEntryName: array[0..256] of Shortint;
    szPhoneNumber: array[0..128] of Shortint;
    szCallbackNumber: array[0..128] of Shortint;
    szUserName: array[0..256] of Shortint;
    szPassword: array[0..256] of Shortint;
    szDomain: array[0..15] of Shortint;
    dwSubEntry: DWORD;
    dwCallbackId: NativeUInt;
    dwIfIndex: DWORD;
    szEncPassword: Pointer;
  end;
const RASDIALPARAMSA = extern struct {
    dwSize: u32,
    szEntryName: [257]i8,
    szPhoneNumber: [129]i8,
    szCallbackNumber: [129]i8,
    szUserName: [257]i8,
    szPassword: [257]i8,
    szDomain: [16]i8,
    dwSubEntry: u32,
    dwCallbackId: usize,
    dwIfIndex: u32,
    szEncPassword: ?*anyopaque,
};
type
  RASDIALPARAMSA {.bycopy.} = object
    dwSize: uint32
    szEntryName: array[257, int8]
    szPhoneNumber: array[129, int8]
    szCallbackNumber: array[129, int8]
    szUserName: array[257, int8]
    szPassword: array[257, int8]
    szDomain: array[16, int8]
    dwSubEntry: uint32
    dwCallbackId: uint
    dwIfIndex: uint32
    szEncPassword: pointer
struct RASDIALPARAMSA
{
    uint dwSize;
    byte[257] szEntryName;
    byte[129] szPhoneNumber;
    byte[129] szCallbackNumber;
    byte[257] szUserName;
    byte[257] szPassword;
    byte[16] szDomain;
    uint dwSubEntry;
    size_t dwCallbackId;
    uint dwIfIndex;
    void* szEncPassword;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; RASDIALPARAMSA サイズ: 1068 バイト(x86)
dim st, 267    ; 4byte整数×267(構造体サイズ 1068 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; szEntryName : CHAR (+4, 257byte)  varptr(st)+4 を基点に操作(257byte:入れ子/配列)
; szPhoneNumber : CHAR (+261, 129byte)  varptr(st)+261 を基点に操作(129byte:入れ子/配列)
; szCallbackNumber : CHAR (+390, 129byte)  varptr(st)+390 を基点に操作(129byte:入れ子/配列)
; szUserName : CHAR (+519, 257byte)  varptr(st)+519 を基点に操作(257byte:入れ子/配列)
; szPassword : CHAR (+776, 257byte)  varptr(st)+776 を基点に操作(257byte:入れ子/配列)
; szDomain : CHAR (+1033, 16byte)  varptr(st)+1033 を基点に操作(16byte:入れ子/配列)
; dwSubEntry : DWORD (+1052, 4byte)  st.263 = 値  /  値 = st.263   (lpoke/lpeek も可)
; dwCallbackId : UINT_PTR (+1056, 4byte)  st.264 = 値  /  値 = st.264   (lpoke/lpeek も可)
; dwIfIndex : DWORD (+1060, 4byte)  st.265 = 値  /  値 = st.265   (lpoke/lpeek も可)
; szEncPassword : LPSTR (+1064, 4byte)  st.266 = 値  /  値 = st.266   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; RASDIALPARAMSA サイズ: 1080 バイト(x64)
dim st, 270    ; 4byte整数×270(構造体サイズ 1080 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; szEntryName : CHAR (+4, 257byte)  varptr(st)+4 を基点に操作(257byte:入れ子/配列)
; szPhoneNumber : CHAR (+261, 129byte)  varptr(st)+261 を基点に操作(129byte:入れ子/配列)
; szCallbackNumber : CHAR (+390, 129byte)  varptr(st)+390 を基点に操作(129byte:入れ子/配列)
; szUserName : CHAR (+519, 257byte)  varptr(st)+519 を基点に操作(257byte:入れ子/配列)
; szPassword : CHAR (+776, 257byte)  varptr(st)+776 を基点に操作(257byte:入れ子/配列)
; szDomain : CHAR (+1033, 16byte)  varptr(st)+1033 を基点に操作(16byte:入れ子/配列)
; dwSubEntry : DWORD (+1052, 4byte)  st.263 = 値  /  値 = st.263   (lpoke/lpeek も可)
; dwCallbackId : UINT_PTR (+1056, 8byte)  qpoke st,1056,値 / qpeek(st,1056)  ※IronHSPのみ。3.7/3.8は lpoke st,1056,下位 : lpoke st,1060,上位
; dwIfIndex : DWORD (+1064, 4byte)  st.266 = 値  /  値 = st.266   (lpoke/lpeek も可)
; szEncPassword : LPSTR (+1072, 8byte)  qpoke st,1072,値 / qpeek(st,1072)  ※IronHSPのみ。3.7/3.8は lpoke st,1072,下位 : lpoke st,1076,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global RASDIALPARAMSA
    #field int dwSize
    #field byte szEntryName 257
    #field byte szPhoneNumber 129
    #field byte szCallbackNumber 129
    #field byte szUserName 257
    #field byte szPassword 257
    #field byte szDomain 16
    #field int dwSubEntry
    #field intptr dwCallbackId
    #field int dwIfIndex
    #field intptr szEncPassword
#endstruct

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