Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Struktur LINEPROXYREQUEST berisi nilai parameter aplikasi yang membuat permintaan proksi. Beberapa fungsi pusat panggilan TAPI menghasilkan pesan LINE_PROXYREQUEST yang mereferensikan struktur LINEPROXYREQUEST .
Sintaks
typedef struct lineproxyrequest_tag {
DWORD dwSize;
DWORD dwClientMachineNameSize;
DWORD dwClientMachineNameOffset;
DWORD dwClientUserNameSize;
DWORD dwClientUserNameOffset;
DWORD dwClientAppAPIVersion;
DWORD dwRequestType;
union {
struct {
DWORD dwAddressID;
LINEAGENTGROUPLIST GroupList;
} SetAgentGroup;
struct {
DWORD dwAddressID;
DWORD dwAgentState;
DWORD dwNextAgentState;
} SetAgentState;
struct {
DWORD dwAddressID;
DWORD dwActivityID;
} SetAgentActivity;
struct {
DWORD dwAddressID;
LINEAGENTCAPS AgentCaps;
} GetAgentCaps;
struct {
DWORD dwAddressID;
LINEAGENTSTATUS AgentStatus;
} GetAgentStatus;
struct {
DWORD dwAddressID;
DWORD dwAgentExtensionIDIndex;
DWORD dwSize;
BYTE Params[1];
} AgentSpecific;
struct {
DWORD dwAddressID;
LINEAGENTACTIVITYLIST ActivityList;
} GetAgentActivityList;
struct {
DWORD dwAddressID;
LINEAGENTGROUPLIST GroupList;
} GetAgentGroupList;
struct {
HAGENT hAgent;
DWORD dwAgentIDSize;
DWORD dwAgentIDOffset;
DWORD dwAgentPINSize;
DWORD dwAgentPINOffset;
} CreateAgent;
struct {
HAGENT hAgent;
DWORD dwAgentState;
DWORD dwNextAgentState;
} SetAgentStateEx;
struct {
HAGENT hAgent;
DWORD dwMeasurementPeriod;
} SetAgentMeasurementPeriod;
struct {
HAGENT hAgent;
LINEAGENTINFO AgentInfo;
} GetAgentInfo;
struct {
HAGENTSESSION hAgentSession;
DWORD dwAgentPINSize;
DWORD dwAgentPINOffset;
HAGENT hAgent;
GUID GroupID;
DWORD dwWorkingAddressID;
} CreateAgentSession;
struct {
HAGENT hAgent;
LINEAGENTSESSIONLIST SessionList;
} GetAgentSessionList;
struct {
HAGENTSESSION hAgentSession;
LINEAGENTSESSIONINFO SessionInfo;
} GetAgentSessionInfo;
struct {
HAGENTSESSION hAgentSession;
DWORD dwAgentSessionState;
DWORD dwNextAgentSessionState;
} SetAgentSessionState;
struct {
GUID GroupID;
LINEQUEUELIST QueueList;
} GetQueueList;
struct {
DWORD dwQueueID;
DWORD dwMeasurementPeriod;
} SetQueueMeasurementPeriod;
struct {
DWORD dwQueueID;
LINEQUEUEINFO QueueInfo;
} GetQueueInfo;
struct {
LINEAGENTGROUPLIST GroupList;
} GetGroupList;
};
} LINEPROXYREQUEST, *LPLINEPROXYREQUEST;
Anggota
dwSize
Jumlah total byte yang dialokasikan oleh TAPI untuk berisi struktur LINEPROXYREQUEST . Anggota dwTotalSize dari struktur apa pun yang terkandung dalam LINEPROXYREQUEST (misalnya, LINEAGENTCAPS) hanya mencerminkan jumlah byte yang dialokasikan untuk struktur tertentu tersebut. Ukuran total, dalam byte, dari blok parameter Params .
dwClientMachineNameSize
Ukuran string nama komputer klien, dalam byte, termasuk karakter null-terminating.
dwClientMachineNameOffset
Offset dari awal struktur ke string yang dihentikan null yang mengidentifikasi komputer klien yang membuat permintaan ini. Ukuran string ditentukan oleh dwClientMachineNameSize.
dwClientUserNameSize
Ukuran string nama pengguna klien, dalam byte, termasuk karakter null-terminating.
dwClientUserNameOffset
Offset dari awal struktur ke string yang dihentikan null yang mengidentifikasi pengguna di akun mana aplikasi berjalan pada komputer klien. Ukuran string ditentukan oleh dwClientUserNameSize.
dwClientAppAPIVersion
Versi API tertinggi didukung oleh aplikasi yang membuat permintaan. Penangan proksi harus membatasi konten data apa pun yang dikembalikan ke aplikasi kepada anggota dan nilai yang ditentukan dalam versi TAPI ini, atau yang lebih lama.
dwRequestType
Salah satu konstanta LINEPROXYREQUEST_. Mengidentifikasi jenis fungsi dan komponen penyatuan yang menentukan data yang tersisa dalam struktur.
SetAgentGroup
Komponen union yang digunakan ketika dwRequestType LINEPROXYREQUEST_SETAGENT.
SetAgentGroup.dwAddressID
Pengidentifikasi alamat tempat agen akan diatur.
SetAgentGroup.GroupList
Struktur jenis LINEAGENTGROUPLIST. Offset dalam struktur ini relatif terhadap awal SetAgentGroup.GroupList daripada ke awal struktur LINEPROXYREQUEST .
SetAgentState
Komponen union yang digunakan ketika dwRequestType LINEPROXYREQUEST_SETAGENTSTATE.
SetAgentState.dwAddressID
Pengidentifikasi alamat yang status agennya akan ditetapkan.
SetAgentState.dwAgentState
Status agen baru, atau nol untuk membiarkan status agen tidak berubah.
SetAgentState.dwNextAgentState
Status agen baru berikutnya, atau nol untuk menggunakan status berikutnya default yang terkait dengan status agen yang ditentukan.
SetAgentActivity
Komponen union yang digunakan ketika dwRequestType LINEPROXYREQUEST_SETAGENTACTIVITY.
SetAgentActivity.dwAddressID
Pengidentifikasi alamat tempat aktivitas agen akan diatur.
SetAgentActivity.dwActivityID
Pengidentifikasi untuk aktivitas yang dipilih.
GetAgentCaps
Komponen union yang digunakan ketika dwRequestType LINEPROXYREQUEST_GETAGENTCAPS.
GetAgentCaps.dwAddressID
Pengidentifikasi alamat tempat kemampuan agen akan diambil.
GetAgentCaps.AgentCaps
Struktur jenis LINEAGENTCAPS. Offset dalam struktur ini relatif terhadap awal GetAgentCaps.AgentCaps daripada ke awal struktur LINEPROXYREQUEST . Anggota dwTotalSize diatur oleh TAPI dan byte yang tersisa diatur ke nol. Handler proksi harus mengisi dwNeededSize, dwUsedSize, dan anggota yang tersisa sebagaimana mestinya, sebelum memanggil lineProxyResponse.
GetAgentStatus
Komponen union yang digunakan ketika dwRequestType LINEPROXYREQUEST_SETAGENTGROUP.
GetAgentStatus.dwAddressID
Pengidentifikasi alamat tempat status agen akan diambil.
GetAgentStatus.AgentStatus
Struktur jenis LINEAGENTSTATUS. Offset dalam struktur ini relatif terhadap awal GetAgentStatus.AgentStatus daripada ke awal struktur LINEPROXYREQUEST . Anggota dwTotalSize diatur oleh TAPI dan byte yang tersisa diatur ke nol. Handler proksi harus mengisi dwNeededSize, dwUsedSize, dan anggota yang tersisa sebagaimana mestinya, sebelum memanggil lineProxyResponse.
AgentSpecific
Komponen union yang digunakan ketika dwRequestType LINEPROXYREQUEST_AGENTSPECIFIC.
AgentSpecific.dwAddressID
Pengidentifikasi alamat tempat status agen akan diambil.
AgentSpecific.dwAgentExtensionIDIndex
Indeks ekstensi handler yang dipanggil; posisi pengidentifikasi dalam array pengidentifikasi ekstensi yang dikembalikan di LINEAGENTCAPS.
AgentSpecific.dwSize
Ukuran total, dalam byte, dari blok parameter Params .
AgentSpecific.Params[1]
Blok memori yang menyertakan konten yang diteruskan ke handler dari aplikasi. Jika handler mengembalikan data ke aplikasi, itu harus ditulis ke blok parameter ini sebelum memanggil lineProxyResponse.
GetAgentActivityList
Komponen union yang digunakan ketika dwRequestType LINEPROXYREQUEST_GETAGENTACTIVITYLIST.
GetAgentActivityList.dwAddressID
Pengidentifikasi alamat tempat daftar aktivitas agen akan diambil.
GetAgentActivityList.ActivityList
Struktur jenis LINEAGENTACTIVITYLIST. Offset dalam struktur ini relatif terhadap awal GetAgentActivityList.ActivityList daripada ke awal struktur LINEPROXYREQUEST . Anggota dwTotalSize diatur oleh TAPI dan byte yang tersisa diatur ke nol. Handler proksi harus mengisi dwNeededSize, dwUsedSize, dan anggota yang tersisa sebagaimana mestinya, sebelum memanggil lineProxyResponse.
GetAgentGroupList
Komponen union yang digunakan ketika dwRequestType LINEPROXYREQUEST_GETAGENTGROUPLIST.
GetAgentGroupList.dwAddressID
Pengidentifikasi alamat tempat daftar grup agen akan diambil.
GetAgentGroupList.GroupList
Struktur jenis LINEAGENTGROUPLIST. Offset dalam struktur ini relatif terhadap awal GetAgentGroupList.GroupList daripada ke awal struktur LINEPROXYREQUEST . Anggota dwTotalSize diatur oleh TAPI dan byte yang tersisa diatur ke nol. Handler proksi harus mengisi dwNeededSize, dwUsedSize, dan anggota yang tersisa sebagaimana mestinya, sebelum memanggil lineProxyResponse.
CreateAgent
Komponen union yang digunakan ketika dwRequestType LINEPROXYREQUEST_CREATEAGENT.
CreateAgent.hAgent
Pengidentifikasi unik untuk agen. Merupakan tanggung jawab penangan agen untuk menghasilkan dan mempertahankan keunikan pengidentifikasi ini.
CreateAgent.dwAgentIDSize
Ukuran string ID agen, dalam byte.
CreateAgent.dwAgentIDOffset
Offset dari awal struktur ke string yang dihentikan null yang menentukan ID agen. Ukuran string ditentukan oleh dwAgentIDSize.
CreateAgent.dwAgentPINSize
Ukuran string PIN termasuk terminator null , dalam byte.
CreateAgent.dwAgentPINOffset
Offset dari awal struktur ke string yang dihentikan null yang menentukan PIN atau kata sandi agen. Ukuran string ditentukan oleh dwAgentPINSize.
SetAgentStateEx
Komponen union yang digunakan ketika dwRequestType LINEPROXYREQUEST_SETAGENTSTATEEX.
SetAgentStateEx.hAgent
Pengidentifikasi unik untuk agen. Merupakan tanggung jawab penangan agen untuk menghasilkan dan mempertahankan keunikan pengidentifikasi ini.
SetAgentStateEx.dwAgentState
Salah satu konstanta LINEAGENTSTATEEX_.
SetAgentStateEx.dwNextAgentState
Salah satu konstanta LINEAGENTSTATEEX_.
SetAgentMeasurementPeriod
Komponen union yang digunakan ketika dwRequestType LINEPROXYREQUEST_SETAGENTMEASUREMENTPERIOD.
SetAgentMeasurementPeriod.hAgent
Pengidentifikasi unik untuk agen. Merupakan tanggung jawab penangan agen untuk menghasilkan dan mempertahankan keunikan pengidentifikasi ini.
SetAgentMeasurementPeriod.dwMeasurementPeriod
Periode di mana sakelar atau implementasi menyimpan dan menghitung informasi, dalam hitungan detik. Misalnya, dwNumberOfACDCalls menyimpan jumlah panggilan yang ditangani agen; dwMeasurementPeriod menunjukkan apakah nilai ini mereferensikan panggilan yang ditangani dalam satu jam, hari, atau bulan terakhir.
GetAgentInfo
Komponen union yang digunakan ketika dwRequestType LINEPROXYREQUEST_GETAGENTINFO.
GetAgentInfo.hAgent
Pengidentifikasi unik untuk agen. Merupakan tanggung jawab penangan agen untuk menghasilkan dan mempertahankan keunikan pengidentifikasi ini.
GetAgentInfo.AgentInfo
Struktur jenis LINEAGENTINFO.
CreateAgentSession
Komponen union yang digunakan ketika dwRequestType LINEPROXYREQUEST_CREATEAGENTSESSION.
CreateAgentSession.hAgentSession
Pengidentifikasi unik untuk sesi agen.
CreateAgentSession.dwAgentPINSize
Ukuran string PIN agen termasuk terminator null , dalam byte.
CreateAgentSession.dwAgentPINOffset
Offset dari awal struktur ke string yang dihentikan null yang menentukan PIN atau kata sandi agen. Ukuran string ini ditentukan oleh dwAgentPINSize.
CreateAgentSession.hAgent
Pengidentifikasi unik untuk agen. Merupakan tanggung jawab penangan agen untuk menghasilkan dan mempertahankan keunikan pengidentifikasi ini.
CreateAgentSession.GroupID
Pengidentifikasi unik universal untuk grup ACD. Merupakan tanggung jawab penangan agen untuk menghasilkan dan mempertahankan keunikan pengidentifikasi ini.
CreateAgentSession.dwWorkingAddressID
Pengidentifikasi alamat tempat agen akan menerima panggilan untuk sesi ini.
GetAgentSessionList
Komponen union yang digunakan ketika dwRequestType LINEPROXYREQUEST_GETAGENTSESSIONLIST.
GetAgentSessionList.hAgent
Pengidentifikasi unik untuk agen. Merupakan tanggung jawab penangan agen untuk menghasilkan dan mempertahankan keunikan pengidentifikasi ini.
GetAgentSessionList.SessionList
Struktur jenis LINEAGENTSESSIONLIST.
GetAgentSessionInfo
Komponen union yang digunakan ketika dwRequestType LINEPROXYREQUEST_GETAGENTSESSIONINFO.
GetAgentSessionInfo.hAgentSession
Pengidentifikasi unik untuk sesi agen. Merupakan tanggung jawab penangan agen untuk menghasilkan dan mempertahankan keunikan pengidentifikasi ini.
GetAgentSessionInfo.SessionInfo
Struktur jenis LINEAGENTSESSIONINFO.
SetAgentSessionState
Komponen union yang digunakan ketika dwRequestType LINEPROXYREQUEST_SETAGENTSESSIONSTATE.
SetAgentSessionState.hAgentSession
Pengidentifikasi unik untuk sesi agen. Merupakan tanggung jawab penangan agen untuk menghasilkan dan mempertahankan keunikan pengidentifikasi ini.
SetAgentSessionState.dwAgentSessionState
Salah satu konstanta LINEAGENTSESSIONSTATE_.
SetAgentSessionState.dwNextAgentSessionState
Salah satu konstanta LINEAGENTSESSIONSTATE_.
GetQueueList
Komponen union yang digunakan ketika dwRequestType LINEPROXYREQUEST_GETQUEUELIST.
GetQueueList.GroupID
Pengidentifikasi unik universal untuk grup ACD. Merupakan tanggung jawab penangan agen untuk menghasilkan dan mempertahankan keunikan pengidentifikasi ini.
GetQueueList.QueueList
Struktur jenis LINEQUEUELIST.
SetQueueMeasurementPeriod
Komponen union yang digunakan ketika dwRequestType LINEPROXYREQUEST_SETQUEUEMEASUREMENTPERIOD.
SetQueueMeasurementPeriod.dwQueueID
Pengidentifikasi unik untuk antrean. Merupakan tanggung jawab penangan agen untuk menghasilkan dan mempertahankan keunikan pengidentifikasi ini.
SetQueueMeasurementPeriod.dwMeasurementPeriod
Periode di mana sakelar atau implementasi menyimpan dan menghitung informasi, dalam hitungan detik.
GetQueueInfo
Komponen union yang digunakan ketika dwRequestType LINEPROXYREQUEST_GETQUEUEINFO.
GetQueueInfo.dwQueueID
Pengidentifikasi unik untuk antrean. Merupakan tanggung jawab penangan agen untuk menghasilkan dan mempertahankan keunikan pengidentifikasi ini.
GetQueueInfo.QueueInfo
Struktur jenis LINEQUEUEINFO.
GetGroupList
Komponen union yang digunakan ketika dwRequestType LINEPROXYREQUEST_GETGROUPLIST.
GetGroupList.GroupList
Struktur jenis LINEAGENTGROUPLIST.
Keterangan
Pengidentifikasi alamat secara permanen dikaitkan dengan alamat; pengidentifikasi tetap konstan di seluruh peningkatan sistem operasi.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header | tapi.h |