fungsi lineCreateAgentA (tapi.h)

Fungsi lineCreateAgent membuat objek Agen baru. Ini menghasilkan pesan LINE_PROXYREQUEST untuk dikirim ke handler fungsi proksi terdaftar, merujuk struktur LINEPROXYREQUEST jenis LINEPROXYREQUEST_CREATEAGENT.

Sintaksis

LONG lineCreateAgentA(
  HLINE    hLine,
  LPCSTR   lpszAgentID,
  LPCSTR   lpszAgentPIN,
  LPHAGENT lphAgent
);

Parameter

hLine

Tangani ke perangkat baris.

lpszAgentID

Penunjuk ke untai (karakter) Unicode null nullyang dihentikan yang berisi pengidentifikasi agen. Digunakan saat bekerja dengan sistem ACD warisan. Dengan sistem ACD yang menggunakan login pengguna sistem operasi untuk autentikasi, lpszAgentID diatur ke NULL.

lpszAgentPIN

Penunjuk ke string Unicodenull yang dihentikan yang berisi PIN atau kata sandi agen. Digunakan saat bekerja dengan sistem ACD warisan. Dengan sistem ACD yang menggunakan login pengguna sistem operasi untuk autentikasi, lpszAgentPIN diatur ke NULL.

lphAgent

Tangani ke 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 lineCreateAgent sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor 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

LINEPROXYREQUEST

LINE_PROXYREQUEST