fungsi lineCreateAgentSessionA (tapi.h)

Fungsi lineCreateAgentSession membuat objek AgentSession baru. Ini menghasilkan pesan LINE_PROXYREQUEST untuk dikirim ke handler fungsi proksi terdaftar, merujuk struktur LINEPROXYREQUEST jenis LINEPROXYREQUEST_CREATEAGENTSESSION.

Sintaksis

LONG lineCreateAgentSessionA(
  HLINE           hLine,
  HAGENT          hAgent,
  LPCSTR          lpszAgentPIN,
  DWORD           dwWorkingAddressID,
  LPGUID          lpGroupID,
  LPHAGENTSESSION lphAgentSession
);

Parameter

hLine

Tangani ke perangkat baris.

hAgent

Pengidentifikasi agen yang sesinya akan dibuat.

lpszAgentPIN

Penunjuk ke string Unicodenull yang dihentikan yang berisi PIN atau kata sandi agen. Digunakan saat bekerja dengan sistem ACD warisan yang memerlukan PIN terpisah untuk setiap sesi yang dibuat (atau grup yang masuk). Dengan sistem ACD yang menggunakan login pengguna sistem operasi untuk autentikasi, lpszAgentPIN diatur ke NULL.

dwWorkingAddressID

Pengidentifikasi alamat tempat agen akan menerima panggilan untuk sesi ini.

lpGroupID

Penunjuk ke GUID yang mengidentifikasi grup tempat sesi sedang dibuat.

lphAgentSession

Tangani ke sesi agen yang dibuat, dikembalikan oleh proksi ACD. Merupakan tanggung jawab aplikasi proksi handler agen untuk menghasilkan dan mempertahankan keunikan pengidentifikasi ini.

Mengembalikan nilai

Mengembalikan pengidentifikasi permintaan jika operasi asinkron dimulai; jika tidak, fungsi mengembalikan salah satu nilai kesalahan berikut:

LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.

Komentar

Nota

Header tapi.h mendefinisikan lineCreateAgentSession sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
Platform Target	Windows
Header	tapi.h
Pustaka	Tapi32.lib
DLL	Tapi32.dll

Lihat juga

Tentang Kontrol Pusat Panggilan

LINEPROXYREQUEST

LINE_PROXYREQUEST