ATM_ADDRESS
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| AddressType | DWORD | 4 | +0 | +0 | エンドシステム ATM アドレスの種類。 |
| NumofDigits | DWORD | 4 | +4 | +4 | Addr パラメーターの桁数。 |
| Addr | BYTE | 20 | +8 | +8 | ATM アドレスを表す配列。 |
公式ドキュメント
ATM_ADDRESS 構造体は、ATM ベースのソケット用の ATM アドレスデータを保持します。
解説(Remarks)
ATM_E164 の場合は、数字キーパッドで入力するのと同じ順序で番号の桁を入力します。つまり、最初に入力される桁が addr に格納されます。桁は IA5 文字でコード化されます。ビット 8 は 0 に設定されます。
ATM_NSAP の場合は、ATM Forum UNI 3.1 で定義されている 2 進化 10 進数 (BCD) を使用してアドレスをコード化します。この場合、NumofDigits フィールドは無視され、NSAP 形式のアドレスは常に 20 バイトになります。
AddressType の値が SAP_FIELD_ANY である場合は、satm_number フィールドがワイルドカードであることを示します。さらに特殊化された 2 つのワイルドカード値、SAP_FIELD_ANY_AESA_SEL と SAP_FIELD_ANY_AESA_REST があります。SAP_FIELD_ANY_AESA_SEL は、これが NSAP 形式の ATM エンドシステムアドレスであり、セレクターオクテットがワイルドカードとして設定されていることを意味します。SAP_FIELD_ANY_AESA_REST は、これが NSAP 形式の ATM エンドシステムアドレスであり、セレクターオクテットを除くすべてのオクテットがワイルドカードとして設定されていることを意味します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// ATM_ADDRESS (x64 28 / x86 28 バイト)
typedef struct ATM_ADDRESS {
DWORD AddressType;
DWORD NumofDigits;
BYTE Addr[20];
} ATM_ADDRESS;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct ATM_ADDRESS
{
public uint AddressType;
public uint NumofDigits;
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 20)] public byte[] Addr;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure ATM_ADDRESS
Public AddressType As UInteger
Public NumofDigits As UInteger
<MarshalAs(UnmanagedType.ByValArray, SizeConst:=20)> Public Addr() As Byte
End Structureimport ctypes
from ctypes import wintypes
class ATM_ADDRESS(ctypes.Structure):
_fields_ = [
("AddressType", wintypes.DWORD),
("NumofDigits", wintypes.DWORD),
("Addr", ctypes.c_ubyte * 20),
]#[repr(C)]
pub struct ATM_ADDRESS {
pub AddressType: u32,
pub NumofDigits: u32,
pub Addr: [u8; 20],
}import "golang.org/x/sys/windows"
type ATM_ADDRESS struct {
AddressType uint32
NumofDigits uint32
Addr [20]byte
}type
ATM_ADDRESS = record
AddressType: DWORD;
NumofDigits: DWORD;
Addr: array[0..19] of Byte;
end;const ATM_ADDRESS = extern struct {
AddressType: u32,
NumofDigits: u32,
Addr: [20]u8,
};type
ATM_ADDRESS {.bycopy.} = object
AddressType: uint32
NumofDigits: uint32
Addr: array[20, uint8]struct ATM_ADDRESS
{
uint AddressType;
uint NumofDigits;
ubyte[20] Addr;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; ATM_ADDRESS サイズ: 28 バイト(x64)
dim st, 7 ; 4byte整数×7(構造体サイズ 28 / 4 切り上げ)
; AddressType : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; NumofDigits : DWORD (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; Addr : BYTE (+8, 20byte) varptr(st)+8 を基点に操作(20byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global ATM_ADDRESS
#field int AddressType
#field int NumofDigits
#field byte Addr 20
#endstruct
stdim st, ATM_ADDRESS ; NSTRUCT 変数を確保
st->AddressType = 100
mes "AddressType=" + st->AddressType