Metode ITAgentHandler::CreateAgentWithID (tapi3cc.h)

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.

Persyaratan

   
Target Platform Windows
Header tapi3cc.h (termasuk Tapi3.h)
Pustaka Uuid.lib
DLL Tapi3.dll

Lihat juga

CreateAgent

ITAgent

ITAgentHandler