LINEAPPINFO

構造体

サイズx64: 40 バイト / x86: 40 バイトパッキング1

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

フィールド

フィールド	型	サイズ	x64	x86	説明
dwMachineNameSize	DWORD	4	+0	+0	null 終端文字を含むコンピューター名文字列のサイズ(バイト単位)。
dwMachineNameOffset	DWORD	4	+4	+4	LINEDEVSTATUS 構造体の先頭から、アプリケーションが実行されているコンピューターの名前を指定する文字列までのオフセット。このフィールドのサイズは dwMachineNameSize で指定されます。
dwUserNameSize	DWORD	4	+8	+8	null 終端文字を含むユーザー名文字列のサイズ(バイト単位)。
dwUserNameOffset	DWORD	4	+12	+12	LINEDEVSTATUS 構造体の先頭から、アプリケーションが実行されているアカウントのユーザー名を指定する文字列までのオフセット。このフィールドのサイズは dwUserNameSize で指定されます。
dwModuleFilenameSize	DWORD	4	+16	+16	モジュールファイル名文字列のサイズ(バイト単位)。
dwModuleFilenameOffset	DWORD	4	+20	+20	LINEDEVSTATUS の先頭から、アプリケーションのモジュールファイル名を指定する文字列までのオフセット。この文字列は、 lineHandoff の呼び出しで、アプリケーションへの指定ハンドオフを実行するために使用できます。このフィールドのサイズは dwModuleFilenameSize で指定されます。
dwFriendlyNameSize	DWORD	4	+24	+24	表示名文字列のサイズ(バイト単位)。
dwFriendlyNameOffset	DWORD	4	+28	+28	LINEDEVSTATUS の先頭から、アプリケーションが lineInitialize または lineInitializeEx に指定した文字列までのオフセット。この文字列は、ユーザーへの表示に使用してください。このフィールドのサイズは dwFriendlyNameSize で指定されます。
dwMediaModes	DWORD	4	+32	+32	アプリケーションが新しい通話の所有権を要求したメディアの種類。回線を開いたときに dwPrivileges に LINECALLPRIVILEGE_OWNER が含まれていなかった場合は 0 です。
dwAddressID	DWORD	4	+36	+36	回線ハンドルが LINEOPENOPTION_SINGLEADDRESS を使用して開かれた場合、指定されたアドレス識別子が格納されます。単一アドレスオプションが使用されなかった場合は 0xFFFFFFFF が設定されます。アドレス識別子はアドレスに永続的に関連付けられます。この識別子はオペレーティングシステムのアップグレードをまたいでも変わりません。

公式ドキュメント

LINEAPPINFO 構造体には、現在実行中のアプリケーションに関する情報が格納されます。 LINEDEVSTATUS 構造体は、 LINEAPPINFO 構造体の配列を格納できます。

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

各言語での定義

#include <windows.h>

// LINEAPPINFO  (x64 40 / x86 40 バイト)
#pragma pack(push, 1)
typedef struct LINEAPPINFO {
    DWORD dwMachineNameSize;
    DWORD dwMachineNameOffset;
    DWORD dwUserNameSize;
    DWORD dwUserNameOffset;
    DWORD dwModuleFilenameSize;
    DWORD dwModuleFilenameOffset;
    DWORD dwFriendlyNameSize;
    DWORD dwFriendlyNameOffset;
    DWORD dwMediaModes;
    DWORD dwAddressID;
} LINEAPPINFO;
#pragma pack(pop)

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct LINEAPPINFO
{
    public uint dwMachineNameSize;
    public uint dwMachineNameOffset;
    public uint dwUserNameSize;
    public uint dwUserNameOffset;
    public uint dwModuleFilenameSize;
    public uint dwModuleFilenameOffset;
    public uint dwFriendlyNameSize;
    public uint dwFriendlyNameOffset;
    public uint dwMediaModes;
    public uint dwAddressID;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure LINEAPPINFO
    Public dwMachineNameSize As UInteger
    Public dwMachineNameOffset As UInteger
    Public dwUserNameSize As UInteger
    Public dwUserNameOffset As UInteger
    Public dwModuleFilenameSize As UInteger
    Public dwModuleFilenameOffset As UInteger
    Public dwFriendlyNameSize As UInteger
    Public dwFriendlyNameOffset As UInteger
    Public dwMediaModes As UInteger
    Public dwAddressID As UInteger
End Structure

import ctypes
from ctypes import wintypes

class LINEAPPINFO(ctypes.Structure):
    _pack_ = 1
    _fields_ = [
        ("dwMachineNameSize", wintypes.DWORD),
        ("dwMachineNameOffset", wintypes.DWORD),
        ("dwUserNameSize", wintypes.DWORD),
        ("dwUserNameOffset", wintypes.DWORD),
        ("dwModuleFilenameSize", wintypes.DWORD),
        ("dwModuleFilenameOffset", wintypes.DWORD),
        ("dwFriendlyNameSize", wintypes.DWORD),
        ("dwFriendlyNameOffset", wintypes.DWORD),
        ("dwMediaModes", wintypes.DWORD),
        ("dwAddressID", wintypes.DWORD),
    ]

#[repr(C, packed(1))]
pub struct LINEAPPINFO {
    pub dwMachineNameSize: u32,
    pub dwMachineNameOffset: u32,
    pub dwUserNameSize: u32,
    pub dwUserNameOffset: u32,
    pub dwModuleFilenameSize: u32,
    pub dwModuleFilenameOffset: u32,
    pub dwFriendlyNameSize: u32,
    pub dwFriendlyNameOffset: u32,
    pub dwMediaModes: u32,
    pub dwAddressID: u32,
}

import "golang.org/x/sys/windows"

type LINEAPPINFO struct {
	dwMachineNameSize uint32
	dwMachineNameOffset uint32
	dwUserNameSize uint32
	dwUserNameOffset uint32
	dwModuleFilenameSize uint32
	dwModuleFilenameOffset uint32
	dwFriendlyNameSize uint32
	dwFriendlyNameOffset uint32
	dwMediaModes uint32
	dwAddressID uint32
}

type
  LINEAPPINFO = packed record
    dwMachineNameSize: DWORD;
    dwMachineNameOffset: DWORD;
    dwUserNameSize: DWORD;
    dwUserNameOffset: DWORD;
    dwModuleFilenameSize: DWORD;
    dwModuleFilenameOffset: DWORD;
    dwFriendlyNameSize: DWORD;
    dwFriendlyNameOffset: DWORD;
    dwMediaModes: DWORD;
    dwAddressID: DWORD;
  end;

const LINEAPPINFO = extern struct {
    dwMachineNameSize: u32,
    dwMachineNameOffset: u32,
    dwUserNameSize: u32,
    dwUserNameOffset: u32,
    dwModuleFilenameSize: u32,
    dwModuleFilenameOffset: u32,
    dwFriendlyNameSize: u32,
    dwFriendlyNameOffset: u32,
    dwMediaModes: u32,
    dwAddressID: u32,
};

type
  LINEAPPINFO {.packed.} = object
    dwMachineNameSize: uint32
    dwMachineNameOffset: uint32
    dwUserNameSize: uint32
    dwUserNameOffset: uint32
    dwModuleFilenameSize: uint32
    dwModuleFilenameOffset: uint32
    dwFriendlyNameSize: uint32
    dwFriendlyNameOffset: uint32
    dwMediaModes: uint32
    dwAddressID: uint32

align(1)
struct LINEAPPINFO
{
    uint dwMachineNameSize;
    uint dwMachineNameOffset;
    uint dwUserNameSize;
    uint dwUserNameOffset;
    uint dwModuleFilenameSize;
    uint dwModuleFilenameOffset;
    uint dwFriendlyNameSize;
    uint dwFriendlyNameOffset;
    uint dwMediaModes;
    uint dwAddressID;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; LINEAPPINFO サイズ: 40 バイト(x64)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; dwMachineNameSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwMachineNameOffset : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; dwUserNameSize : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; dwUserNameOffset : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; dwModuleFilenameSize : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; dwModuleFilenameOffset : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; dwFriendlyNameSize : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; dwFriendlyNameOffset : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; dwMediaModes : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; dwAddressID : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global LINEAPPINFO, pack=1
    #field int dwMachineNameSize
    #field int dwMachineNameOffset
    #field int dwUserNameSize
    #field int dwUserNameOffset
    #field int dwModuleFilenameSize
    #field int dwModuleFilenameOffset
    #field int dwFriendlyNameSize
    #field int dwFriendlyNameOffset
    #field int dwMediaModes
    #field int dwAddressID
#endstruct

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

LINEAPPINFO

フィールド

公式ドキュメント

各言語での定義

HSP用 定義

HSP用定義