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

LINEPROXYREQUEST

構造体
サイズx64: 36 バイト / x86: 32 バイトパッキング1

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

フィールド

フィールドサイズx64x86説明
dwSizeDWORD4+0+0TAPI が LINEPROXYREQUEST 構造体を格納するために割り当てた合計バイト数です。 LINEPROXYREQUEST 内に含まれる構造体 (たとえば LINEAGENTCAPS) の dwTotalSize メンバーは、その特定の構造体に対して割り当てられたバイト数のみを反映します。 Params パラメーターブロックの合計サイズ (バイト単位) です。
dwClientMachineNameSizeDWORD4+4+4クライアントマシン名文字列のサイズ (バイト単位)。null 終端文字を含みます。
dwClientMachineNameOffsetDWORD4+8+8この要求を行ったクライアントマシンを識別する null 終端文字列への、構造体の先頭からのオフセットです。文字列のサイズは dwClientMachineNameSize で指定されます。
dwClientUserNameSizeDWORD4+12+12クライアントユーザー名文字列のサイズ (バイト単位)。null 終端文字を含みます。
dwClientUserNameOffsetDWORD4+16+16クライアントマシン上でアプリケーションを実行しているアカウントのユーザーを識別する null 終端文字列への、構造体の先頭からのオフセットです。文字列のサイズは dwClientUserNameSize で指定されます。
dwClientAppAPIVersionDWORD4+20+20要求を行ったアプリケーションがサポートする最上位の API バージョンです。プロキシハンドラーは、アプリケーションに返すデータの内容を、このバージョンまたはそれ以前の TAPI で定義されていたメンバーおよび値に制限する必要があります。
dwRequestTypeDWORD4+24+24LINEPROXYREQUEST_ 定数 のいずれかです。関数の種類と、構造体内の残りのデータを定義する共用体メンバーを識別します。
Anonymous_Anonymous_e__Union8/4+28+28要求種別ごとに異なるパラメータを格納する無名共用体。種別に応じた一方のメンバを使う。

共用体: _Anonymous_e__Union x64 8B / x86 4B

フィールドサイズx64x86説明
SetAgentGroup_SetAgentGroup_e__Struct8/4+0+0dwRequestType が LINEPROXYREQUEST_SETAGENT の場合に使用される共用体メンバーです。
SetAgentState_SetAgentState_e__Struct8/4+0+0dwRequestTypeLINEPROXYREQUEST_SETAGENTSTATE の場合に使用される共用体メンバーです。
SetAgentActivity_SetAgentActivity_e__Struct8/4+0+0dwRequestTypeLINEPROXYREQUEST_SETAGENTACTIVITY の場合に使用される共用体メンバーです。
GetAgentCaps_GetAgentCaps_e__Struct8/4+0+0dwRequestTypeLINEPROXYREQUEST_GETAGENTCAPS の場合に使用される共用体メンバーです。
GetAgentStatus_GetAgentStatus_e__Struct8/4+0+0dwRequestTypeLINEPROXYREQUEST_SETAGENTGROUP の場合に使用される共用体メンバーです。
AgentSpecific_AgentSpecific_e__Struct8/4+0+0dwRequestTypeLINEPROXYREQUEST_AGENTSPECIFIC の場合に使用される共用体メンバーです。
GetAgentActivityList_GetAgentActivityList_e__Struct8/4+0+0dwRequestTypeLINEPROXYREQUEST_GETAGENTACTIVITYLIST の場合に使用される共用体メンバーです。
GetAgentGroupList_GetAgentGroupList_e__Struct8/4+0+0dwRequestTypeLINEPROXYREQUEST_GETAGENTGROUPLIST の場合に使用される共用体メンバーです。
CreateAgent_CreateAgent_e__Struct8/4+0+0dwRequestTypeLINEPROXYREQUEST_CREATEAGENT の場合に使用される共用体メンバーです。
SetAgentStateEx_SetAgentStateEx_e__Struct8/4+0+0dwRequestTypeLINEPROXYREQUEST_SETAGENTSTATEEX の場合に使用される共用体メンバーです。
SetAgentMeasurementPeriod_SetAgentMeasurementPeriod_e__Struct8/4+0+0dwRequestTypeLINEPROXYREQUEST_SETAGENTMEASUREMENTPERIOD の場合に使用される共用体メンバーです。
GetAgentInfo_GetAgentInfo_e__Struct8/4+0+0dwRequestTypeLINEPROXYREQUEST_GETAGENTINFO の場合に使用される共用体メンバーです。
CreateAgentSession_CreateAgentSession_e__Struct8/4+0+0dwRequestTypeLINEPROXYREQUEST_CREATEAGENTSESSION の場合に使用される共用体メンバーです。
GetAgentSessionList_GetAgentSessionList_e__Struct8/4+0+0dwRequestTypeLINEPROXYREQUEST_GETAGENTSESSIONLIST の場合に使用される共用体メンバーです。
GetAgentSessionInfo_GetAgentSessionInfo_e__Struct8/4+0+0dwRequestTypeLINEPROXYREQUEST_GETAGENTSESSIONINFO の場合に使用される共用体メンバーです。
SetAgentSessionState_SetAgentSessionState_e__Struct8/4+0+0dwRequestTypeLINEPROXYREQUEST_SETAGENTSESSIONSTATE の場合に使用される共用体メンバーです。
GetQueueList_GetQueueList_e__Struct8/4+0+0dwRequestTypeLINEPROXYREQUEST_GETQUEUELIST の場合に使用される共用体メンバーです。
SetQueueMeasurementPeriod_SetQueueMeasurementPeriod_e__Struct8/4+0+0dwRequestTypeLINEPROXYREQUEST_SETQUEUEMEASUREMENTPERIOD の場合に使用される共用体メンバーです。
GetQueueInfo_GetQueueInfo_e__Struct8/4+0+0dwRequestTypeLINEPROXYREQUEST_GETQUEUEINFO の場合に使用される共用体メンバーです。
GetGroupList_GetGroupList_e__Struct8/4+0+0dwRequestTypeLINEPROXYREQUEST_GETGROUPLIST の場合に使用される共用体メンバーです。

公式ドキュメント

LINEPROXYREQUEST 構造体には、プロキシ要求を行うアプリケーションのパラメーター値が格納されます。複数の TAPI コールセンター関数 は、 LINEPROXYREQUEST 構造体を参照する LINE_PROXYREQUEST メッセージを生成します。

解説(Remarks)

アドレス識別子はアドレスに永続的に関連付けられます。この識別子はオペレーティングシステムのアップグレード後も変わりません。

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

各言語での定義

#include <windows.h>

// LINEPROXYREQUEST  (x64 36 / x86 32 バイト)
#pragma pack(push, 1)
typedef struct LINEPROXYREQUEST {
    DWORD dwSize;
    DWORD dwClientMachineNameSize;
    DWORD dwClientMachineNameOffset;
    DWORD dwClientUserNameSize;
    DWORD dwClientUserNameOffset;
    DWORD dwClientAppAPIVersion;
    DWORD dwRequestType;
    _Anonymous_e__Union Anonymous;
} LINEPROXYREQUEST;
#pragma pack(pop)
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct LINEPROXYREQUEST
{
    public uint dwSize;
    public uint dwClientMachineNameSize;
    public uint dwClientMachineNameOffset;
    public uint dwClientUserNameSize;
    public uint dwClientUserNameOffset;
    public uint dwClientAppAPIVersion;
    public uint dwRequestType;
    public _Anonymous_e__Union Anonymous;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure LINEPROXYREQUEST
    Public dwSize As UInteger
    Public dwClientMachineNameSize As UInteger
    Public dwClientMachineNameOffset As UInteger
    Public dwClientUserNameSize As UInteger
    Public dwClientUserNameOffset As UInteger
    Public dwClientAppAPIVersion As UInteger
    Public dwRequestType As UInteger
    Public Anonymous As _Anonymous_e__Union
End Structure
import ctypes
from ctypes import wintypes

class LINEPROXYREQUEST(ctypes.Structure):
    _pack_ = 1
    _fields_ = [
        ("dwSize", wintypes.DWORD),
        ("dwClientMachineNameSize", wintypes.DWORD),
        ("dwClientMachineNameOffset", wintypes.DWORD),
        ("dwClientUserNameSize", wintypes.DWORD),
        ("dwClientUserNameOffset", wintypes.DWORD),
        ("dwClientAppAPIVersion", wintypes.DWORD),
        ("dwRequestType", wintypes.DWORD),
        ("Anonymous", _Anonymous_e__Union),
    ]
#[repr(C, packed(1))]
pub struct LINEPROXYREQUEST {
    pub dwSize: u32,
    pub dwClientMachineNameSize: u32,
    pub dwClientMachineNameOffset: u32,
    pub dwClientUserNameSize: u32,
    pub dwClientUserNameOffset: u32,
    pub dwClientAppAPIVersion: u32,
    pub dwRequestType: u32,
    pub Anonymous: _Anonymous_e__Union,
}
import "golang.org/x/sys/windows"

type LINEPROXYREQUEST struct {
	dwSize uint32
	dwClientMachineNameSize uint32
	dwClientMachineNameOffset uint32
	dwClientUserNameSize uint32
	dwClientUserNameOffset uint32
	dwClientAppAPIVersion uint32
	dwRequestType uint32
	Anonymous _Anonymous_e__Union
}
type
  LINEPROXYREQUEST = packed record
    dwSize: DWORD;
    dwClientMachineNameSize: DWORD;
    dwClientMachineNameOffset: DWORD;
    dwClientUserNameSize: DWORD;
    dwClientUserNameOffset: DWORD;
    dwClientAppAPIVersion: DWORD;
    dwRequestType: DWORD;
    Anonymous: _Anonymous_e__Union;
  end;
const LINEPROXYREQUEST = extern struct {
    dwSize: u32,
    dwClientMachineNameSize: u32,
    dwClientMachineNameOffset: u32,
    dwClientUserNameSize: u32,
    dwClientUserNameOffset: u32,
    dwClientAppAPIVersion: u32,
    dwRequestType: u32,
    Anonymous: _Anonymous_e__Union,
};
type
  LINEPROXYREQUEST {.packed.} = object
    dwSize: uint32
    dwClientMachineNameSize: uint32
    dwClientMachineNameOffset: uint32
    dwClientUserNameSize: uint32
    dwClientUserNameOffset: uint32
    dwClientAppAPIVersion: uint32
    dwRequestType: uint32
    Anonymous: _Anonymous_e__Union
align(1)
struct LINEPROXYREQUEST
{
    uint dwSize;
    uint dwClientMachineNameSize;
    uint dwClientMachineNameOffset;
    uint dwClientUserNameSize;
    uint dwClientUserNameOffset;
    uint dwClientAppAPIVersion;
    uint dwRequestType;
    _Anonymous_e__Union Anonymous;
}

HSP用 定義

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

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

stdim st, LINEPROXYREQUEST        ; NSTRUCT 変数を確保
st->dwSize = 100
mes "dwSize=" + st->dwSize
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。