Metode ITAgentHandler::CreateAgentWithID (tapi3cc.h)

Artikel
08/26/2023

Metode CreateAgentWithID membuat objek Agen berdasarkan pengidentifikasi agen. Pengidentifikasi ini adalah string yang mengidentifikasi agen pada sistem ACD warisan. Jika sistem juga memerlukan PIN atau kata sandi untuk masuk ke grup, Anda menggunakan metode ini untuk mengatur PIN atau kata sandi.

Sintaks

HRESULT CreateAgentWithID(
  [in]  BSTR    pID,
  [in]  BSTR    pPIN,
  [out] ITAgent **ppAgent
);

Parameter

[in] pID

Penunjuk ke BSTR yang berisi pengidentifikasi agen.

[in] pPIN

Pointer ke BSTR yang berisi PIN agen.

[out] ppAgent

Arahkan ke antarmuka ITAgent .

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Makna
S_OK	Metode berhasil.
E_INVALIDARG	Parameter pPIN adalah NULL.
E_POINTER	Parameter ppAgent bukan penunjuk yang valid.
E_OUTOFMEMORY	Memori tidak cukup ada untuk melakukan operasi.
TAPI_E_TIMEOUT	Operasi gagal karena DLL TAPI 3 kehabisan waktu. Interval batas waktu adalah dua menit.

Keterangan

Aplikasi harus menggunakan SysAllocString untuk mengalokasikan memori untuk parameter pID dan pPIN , dan menggunakan SysFreeString untuk membebaskan memori ketika variabel tidak lagi diperlukan.

TAPI memanggil metode AddRef pada antarmuka ITAgent yang dikembalikan oleh ITAgentHandler::CreateAgentWithID. Aplikasi harus memanggil Rilis pada antarmuka ITAgent ke sumber daya gratis yang terkait dengannya.