Win32 API 日本語リファレンス
ホーム › Devices.Tapi › LINEFORWARD

LINEFORWARD

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 24 バイト / x86: 24 バイトパッキング1

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

フィールド

フィールド型サイズx64x86説明
dwForwardModeDWORD4+0+0転送の種類です。このメンバーは LINEFORWARDMODE_ 定数のいずれかを使用します。
dwCallerAddressSizeDWORD4+4+4転送対象となる発信者のアドレスを格納する可変長フィールドのサイズ (バイト単位)。
dwCallerAddressOffsetDWORD4+8+8

この構造体の先頭から、転送対象となる発信者のアドレスを格納する可変長フィールドまでのオフセットです。dwForwardMode が次のいずれかの値でない場合、このメンバーは 0 に設定されます。

LINEFORWARDMODE_BUSYNASPECIFIC

LINEFORWARDMODE_NOANSWSPECIFIC

LINEFORWARDMODE_UNCONDSPECIFIC

LINEFORWARDMODE_BUSYSPECIFIC

このフィールドのサイズは dwCallerAddressSize で指定されます。

dwDestCountryCodeDWORD4+12+12呼び出しの転送先アドレスの国または地域コードです。
dwDestAddressSizeDWORD4+16+16呼び出しの転送先となるアドレスを格納する可変長フィールドのサイズ (バイト単位)。
dwDestAddressOffsetDWORD4+20+20この構造体の先頭から、呼び出しの転送先となるアドレスを格納する可変長フィールドまでのオフセットです。このフィールドのサイズは dwDestAddressSize で指定されます。

公式ドキュメント

LINEFORWARD 構造体は、転送指示のエントリを記述します。 LINEFORWARDLIST 構造体および LINEADDRESSSTATUS 構造体は、 LINEFORWARD 構造体の配列を含むことができます。

解説(Remarks)

この構造体は拡張できません。

LINEFORWARD 構造体の各エントリは、転送要求を指定します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// LINEFORWARD  (x64 24 / x86 24 バイト)
#pragma pack(push, 1)
typedef struct LINEFORWARD {
    DWORD dwForwardMode;
    DWORD dwCallerAddressSize;
    DWORD dwCallerAddressOffset;
    DWORD dwDestCountryCode;
    DWORD dwDestAddressSize;
    DWORD dwDestAddressOffset;
} LINEFORWARD;
#pragma pack(pop)
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct LINEFORWARD
{
    public uint dwForwardMode;
    public uint dwCallerAddressSize;
    public uint dwCallerAddressOffset;
    public uint dwDestCountryCode;
    public uint dwDestAddressSize;
    public uint dwDestAddressOffset;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure LINEFORWARD
    Public dwForwardMode As UInteger
    Public dwCallerAddressSize As UInteger
    Public dwCallerAddressOffset As UInteger
    Public dwDestCountryCode As UInteger
    Public dwDestAddressSize As UInteger
    Public dwDestAddressOffset As UInteger
End Structure
import ctypes
from ctypes import wintypes

class LINEFORWARD(ctypes.Structure):
    _pack_ = 1
    _fields_ = [
        ("dwForwardMode", wintypes.DWORD),
        ("dwCallerAddressSize", wintypes.DWORD),
        ("dwCallerAddressOffset", wintypes.DWORD),
        ("dwDestCountryCode", wintypes.DWORD),
        ("dwDestAddressSize", wintypes.DWORD),
        ("dwDestAddressOffset", wintypes.DWORD),
    ]
#[repr(C, packed(1))]
pub struct LINEFORWARD {
    pub dwForwardMode: u32,
    pub dwCallerAddressSize: u32,
    pub dwCallerAddressOffset: u32,
    pub dwDestCountryCode: u32,
    pub dwDestAddressSize: u32,
    pub dwDestAddressOffset: u32,
}
import "golang.org/x/sys/windows"

type LINEFORWARD struct {
	dwForwardMode uint32
	dwCallerAddressSize uint32
	dwCallerAddressOffset uint32
	dwDestCountryCode uint32
	dwDestAddressSize uint32
	dwDestAddressOffset uint32
}
type
  LINEFORWARD = packed record
    dwForwardMode: DWORD;
    dwCallerAddressSize: DWORD;
    dwCallerAddressOffset: DWORD;
    dwDestCountryCode: DWORD;
    dwDestAddressSize: DWORD;
    dwDestAddressOffset: DWORD;
  end;
const LINEFORWARD = extern struct {
    dwForwardMode: u32,
    dwCallerAddressSize: u32,
    dwCallerAddressOffset: u32,
    dwDestCountryCode: u32,
    dwDestAddressSize: u32,
    dwDestAddressOffset: u32,
};
type
  LINEFORWARD {.packed.} = object
    dwForwardMode: uint32
    dwCallerAddressSize: uint32
    dwCallerAddressOffset: uint32
    dwDestCountryCode: uint32
    dwDestAddressSize: uint32
    dwDestAddressOffset: uint32
align(1)
struct LINEFORWARD
{
    uint dwForwardMode;
    uint dwCallerAddressSize;
    uint dwCallerAddressOffset;
    uint dwDestCountryCode;
    uint dwDestAddressSize;
    uint dwDestAddressOffset;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; LINEFORWARD サイズ: 24 バイト(x64)
dim st, 6    ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; dwForwardMode : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwCallerAddressSize : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; dwCallerAddressOffset : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; dwDestCountryCode : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; dwDestAddressSize : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; dwDestAddressOffset : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global LINEFORWARD, pack=1
    #field int dwForwardMode
    #field int dwCallerAddressSize
    #field int dwCallerAddressOffset
    #field int dwDestCountryCode
    #field int dwDestAddressSize
    #field int dwDestAddressOffset
#endstruct

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