Bagikan melalui


Struktur LINEPROXYREQUEST (tapi.h)

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

Lihat juga

LINEAGENTACTIVITYLIST

LINEAGENTCAPS

LINEAGENTGROUPLIST

LINEAGENTSESSIONINFO

LINEAGENTSESSIONLIST

LINEAGENTSTATUS

LINEQUEUELIST

LINE_PROXYREQUEST

lineProxyResponse