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

LINEAGENTENTRY

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

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

フィールド

フィールド型サイズx64x86説明
hAgentDWORD4+0+0エージェントの一意な識別子です。これらの識別子を生成し、その一意性を維持することは、エージェントハンドラーの責任です。
dwNameSizeDWORD4+4+4null 終端文字を含む、エージェント名文字列のサイズ (バイト単位)。
dwNameOffsetDWORD4+8+8構造体の先頭から、エージェントの名前を指定する null 終端文字列までのオフセット。この名前は、オペレーティングシステムのユーザー名でもあります。文字列のサイズは dwNameSize で指定します。
dwIDSizeDWORD4+12+12null 終端文字を含む、ID 文字列のサイズ (バイト単位)。
dwIDOffsetDWORD4+16+16構造体の先頭から、エージェントの ID を指定する null 終端文字列までのオフセット。従来の ACD システムがエージェントを識別するために使用します。文字列のサイズは dwIDSize で指定します。
dwPINSizeDWORD4+20+20PIN 文字列のサイズ (バイト単位)。
dwPINOffsetDWORD4+24+24構造体の先頭から、エージェントの PIN またはパスワードを指定する null 終端文字列までのオフセット。従来の ACD システムがエージェントの認可のために使用します。文字列のサイズは dwPINSize で指定します。

公式ドキュメント

LINEAGENTENTRY 構造体は、個々の ACD エージェントを記述します。 LINEAGENTLIST 構造体には、 LINEAGENTENTRY 構造体の配列を格納できます。

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

各言語での定義

#include <windows.h>

// LINEAGENTENTRY  (x64 28 / x86 28 バイト)
#pragma pack(push, 1)
typedef struct LINEAGENTENTRY {
    DWORD hAgent;
    DWORD dwNameSize;
    DWORD dwNameOffset;
    DWORD dwIDSize;
    DWORD dwIDOffset;
    DWORD dwPINSize;
    DWORD dwPINOffset;
} LINEAGENTENTRY;
#pragma pack(pop)
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct LINEAGENTENTRY
{
    public uint hAgent;
    public uint dwNameSize;
    public uint dwNameOffset;
    public uint dwIDSize;
    public uint dwIDOffset;
    public uint dwPINSize;
    public uint dwPINOffset;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure LINEAGENTENTRY
    Public hAgent As UInteger
    Public dwNameSize As UInteger
    Public dwNameOffset As UInteger
    Public dwIDSize As UInteger
    Public dwIDOffset As UInteger
    Public dwPINSize As UInteger
    Public dwPINOffset As UInteger
End Structure
import ctypes
from ctypes import wintypes

class LINEAGENTENTRY(ctypes.Structure):
    _pack_ = 1
    _fields_ = [
        ("hAgent", wintypes.DWORD),
        ("dwNameSize", wintypes.DWORD),
        ("dwNameOffset", wintypes.DWORD),
        ("dwIDSize", wintypes.DWORD),
        ("dwIDOffset", wintypes.DWORD),
        ("dwPINSize", wintypes.DWORD),
        ("dwPINOffset", wintypes.DWORD),
    ]
#[repr(C, packed(1))]
pub struct LINEAGENTENTRY {
    pub hAgent: u32,
    pub dwNameSize: u32,
    pub dwNameOffset: u32,
    pub dwIDSize: u32,
    pub dwIDOffset: u32,
    pub dwPINSize: u32,
    pub dwPINOffset: u32,
}
import "golang.org/x/sys/windows"

type LINEAGENTENTRY struct {
	hAgent uint32
	dwNameSize uint32
	dwNameOffset uint32
	dwIDSize uint32
	dwIDOffset uint32
	dwPINSize uint32
	dwPINOffset uint32
}
type
  LINEAGENTENTRY = packed record
    hAgent: DWORD;
    dwNameSize: DWORD;
    dwNameOffset: DWORD;
    dwIDSize: DWORD;
    dwIDOffset: DWORD;
    dwPINSize: DWORD;
    dwPINOffset: DWORD;
  end;
const LINEAGENTENTRY = extern struct {
    hAgent: u32,
    dwNameSize: u32,
    dwNameOffset: u32,
    dwIDSize: u32,
    dwIDOffset: u32,
    dwPINSize: u32,
    dwPINOffset: u32,
};
type
  LINEAGENTENTRY {.packed.} = object
    hAgent: uint32
    dwNameSize: uint32
    dwNameOffset: uint32
    dwIDSize: uint32
    dwIDOffset: uint32
    dwPINSize: uint32
    dwPINOffset: uint32
align(1)
struct LINEAGENTENTRY
{
    uint hAgent;
    uint dwNameSize;
    uint dwNameOffset;
    uint dwIDSize;
    uint dwIDOffset;
    uint dwPINSize;
    uint dwPINOffset;
}

HSP用 定義

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

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

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