ホーム › Devices.Tapi › LINEPROXYREQUEST
LINEPROXYREQUEST
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| dwSize | DWORD | 4 | +0 | +0 | TAPI が LINEPROXYREQUEST 構造体を格納するために割り当てた合計バイト数です。 LINEPROXYREQUEST 内に含まれる構造体 (たとえば LINEAGENTCAPS) の dwTotalSize メンバーは、その特定の構造体に対して割り当てられたバイト数のみを反映します。 Params パラメーターブロックの合計サイズ (バイト単位) です。 |
| dwClientMachineNameSize | DWORD | 4 | +4 | +4 | クライアントマシン名文字列のサイズ (バイト単位)。null 終端文字を含みます。 |
| dwClientMachineNameOffset | DWORD | 4 | +8 | +8 | この要求を行ったクライアントマシンを識別する null 終端文字列への、構造体の先頭からのオフセットです。文字列のサイズは dwClientMachineNameSize で指定されます。 |
| dwClientUserNameSize | DWORD | 4 | +12 | +12 | クライアントユーザー名文字列のサイズ (バイト単位)。null 終端文字を含みます。 |
| dwClientUserNameOffset | DWORD | 4 | +16 | +16 | クライアントマシン上でアプリケーションを実行しているアカウントのユーザーを識別する null 終端文字列への、構造体の先頭からのオフセットです。文字列のサイズは dwClientUserNameSize で指定されます。 |
| dwClientAppAPIVersion | DWORD | 4 | +20 | +20 | 要求を行ったアプリケーションがサポートする最上位の API バージョンです。プロキシハンドラーは、アプリケーションに返すデータの内容を、このバージョンまたはそれ以前の TAPI で定義されていたメンバーおよび値に制限する必要があります。 |
| dwRequestType | DWORD | 4 | +24 | +24 | LINEPROXYREQUEST_ 定数 のいずれかです。関数の種類と、構造体内の残りのデータを定義する共用体メンバーを識別します。 |
| Anonymous | _Anonymous_e__Union | 8/4 | +28 | +28 | 要求種別ごとに異なるパラメータを格納する無名共用体。種別に応じた一方のメンバを使う。 |
共用体: _Anonymous_e__Union x64 8B / x86 4B
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| SetAgentGroup | _SetAgentGroup_e__Struct | 8/4 | +0 | +0 | dwRequestType が LINEPROXYREQUEST_SETAGENT の場合に使用される共用体メンバーです。 |
| SetAgentState | _SetAgentState_e__Struct | 8/4 | +0 | +0 | dwRequestType が LINEPROXYREQUEST_SETAGENTSTATE の場合に使用される共用体メンバーです。 |
| SetAgentActivity | _SetAgentActivity_e__Struct | 8/4 | +0 | +0 | dwRequestType が LINEPROXYREQUEST_SETAGENTACTIVITY の場合に使用される共用体メンバーです。 |
| GetAgentCaps | _GetAgentCaps_e__Struct | 8/4 | +0 | +0 | dwRequestType が LINEPROXYREQUEST_GETAGENTCAPS の場合に使用される共用体メンバーです。 |
| GetAgentStatus | _GetAgentStatus_e__Struct | 8/4 | +0 | +0 | dwRequestType が LINEPROXYREQUEST_SETAGENTGROUP の場合に使用される共用体メンバーです。 |
| AgentSpecific | _AgentSpecific_e__Struct | 8/4 | +0 | +0 | dwRequestType が LINEPROXYREQUEST_AGENTSPECIFIC の場合に使用される共用体メンバーです。 |
| GetAgentActivityList | _GetAgentActivityList_e__Struct | 8/4 | +0 | +0 | dwRequestType が LINEPROXYREQUEST_GETAGENTACTIVITYLIST の場合に使用される共用体メンバーです。 |
| GetAgentGroupList | _GetAgentGroupList_e__Struct | 8/4 | +0 | +0 | dwRequestType が LINEPROXYREQUEST_GETAGENTGROUPLIST の場合に使用される共用体メンバーです。 |
| CreateAgent | _CreateAgent_e__Struct | 8/4 | +0 | +0 | dwRequestType が LINEPROXYREQUEST_CREATEAGENT の場合に使用される共用体メンバーです。 |
| SetAgentStateEx | _SetAgentStateEx_e__Struct | 8/4 | +0 | +0 | dwRequestType が LINEPROXYREQUEST_SETAGENTSTATEEX の場合に使用される共用体メンバーです。 |
| SetAgentMeasurementPeriod | _SetAgentMeasurementPeriod_e__Struct | 8/4 | +0 | +0 | dwRequestType が LINEPROXYREQUEST_SETAGENTMEASUREMENTPERIOD の場合に使用される共用体メンバーです。 |
| GetAgentInfo | _GetAgentInfo_e__Struct | 8/4 | +0 | +0 | dwRequestType が LINEPROXYREQUEST_GETAGENTINFO の場合に使用される共用体メンバーです。 |
| CreateAgentSession | _CreateAgentSession_e__Struct | 8/4 | +0 | +0 | dwRequestType が LINEPROXYREQUEST_CREATEAGENTSESSION の場合に使用される共用体メンバーです。 |
| GetAgentSessionList | _GetAgentSessionList_e__Struct | 8/4 | +0 | +0 | dwRequestType が LINEPROXYREQUEST_GETAGENTSESSIONLIST の場合に使用される共用体メンバーです。 |
| GetAgentSessionInfo | _GetAgentSessionInfo_e__Struct | 8/4 | +0 | +0 | dwRequestType が LINEPROXYREQUEST_GETAGENTSESSIONINFO の場合に使用される共用体メンバーです。 |
| SetAgentSessionState | _SetAgentSessionState_e__Struct | 8/4 | +0 | +0 | dwRequestType が LINEPROXYREQUEST_SETAGENTSESSIONSTATE の場合に使用される共用体メンバーです。 |
| GetQueueList | _GetQueueList_e__Struct | 8/4 | +0 | +0 | dwRequestType が LINEPROXYREQUEST_GETQUEUELIST の場合に使用される共用体メンバーです。 |
| SetQueueMeasurementPeriod | _SetQueueMeasurementPeriod_e__Struct | 8/4 | +0 | +0 | dwRequestType が LINEPROXYREQUEST_SETQUEUEMEASUREMENTPERIOD の場合に使用される共用体メンバーです。 |
| GetQueueInfo | _GetQueueInfo_e__Struct | 8/4 | +0 | +0 | dwRequestType が LINEPROXYREQUEST_GETQUEUEINFO の場合に使用される共用体メンバーです。 |
| GetGroupList | _GetGroupList_e__Struct | 8/4 | +0 | +0 | dwRequestType が LINEPROXYREQUEST_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)
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 Structureimport 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__Unionalign(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 非対応)。必要に応じ手動でアクセス。