ITAddress::CreateCall method (tapi3if.h)

Artikel
03/02/2024

Metode CreateCall membuat objek Panggilan baru yang dapat digunakan untuk melakukan panggilan keluar dan mengembalikan penunjuk ke antarmuka ITBasicCallControl objek. Panggilan yang baru dibuat berada dalam status CS_IDLE dan tidak memiliki media atau terminal yang dipilih.

Nilai input yang dapat diterima untuk alamat panggilan, jenis alamat, dan jenis media khusus untuk penyedia layanan telepon yang mendukung alamat saat ini. Untuk informasi tentang TSP yang dikirim dengan Windows 2000, lihat Tentang Penyedia Layanan Telepon (TSP). Untuk TSP pihak ketiga, lihat dokumentasi yang disediakan oleh vender.

Sintaks

HRESULT CreateCall(
  [in]  BSTR               pDestAddress,
  [in]  long               lAddressType,
  [in]  long               lMediaTypes,
  [out] ITBasicCallControl **ppCall
);

Parameter

[in] pDestAddress

String BSTR ini berisi alamat tujuan. Formatnya khusus penyedia. Penunjuk ini dapat berupa NULL untuk alamat yang tidak diputar (seperti dengan telepon panas) atau ketika semua panggilan dilakukan menggunakan ITBasicCallControl::D ial. NULL dalam kombinasi dengan pGroupIDNULL di ITBasicCallControl::P ickup menghasilkan pengambilan grup. Penyedia layanan yang memiliki kemampuan multipleks terbalik dapat memungkinkan aplikasi menentukan beberapa alamat sekaligus.

[in] lAddressType

Berisi konstanta jenis alamat , seperti LINEADDRESSTYPE_PHONENUMBER, yang menjelaskan format alamat. Nilai harus valid untuk alamat ini. Gunakan ITAddressCapabilities::get_AddressCapability dengan AddressCap diatur ke AC_ADDRESSTYPES untuk memverifikasi nilai.

[in] lMediaTypes

Mengidentifikasi jenis atau jenis media yang akan terlibat dalam sesi panggilan.

[out] ppCall

Penunjuk ke antarmuka ITBasicCallControl .

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Makna
S_OK	Metode berhasil.
E_INVALIDARG	Jenis alamat, lAddressType, tidak valid atau menentukan lebih dari satu jenis alamat.
E_OUTOFMEMORY	Tidak ada cukup memori untuk melakukan operasi.
E_POINTER	Parameter ppCall bukan penunjuk yang valid.

Keterangan

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

Ketika jenis alamat LINEADDRESSTYPE_SDP, aplikasi harus memanggil metode ITSDP::get_IsValid pada pDestAddress untuk memverifikasi bahwa informasi SDP yang terkandung dibuat dengan benar sesuai dengan RFC 2327.

Panggilan yang digunakan sebagai panggilan konsultasi, seperti selama operasi konferensi, transfer, atau penerusan, harus dibuat menggunakan metode ini.

TAPI memanggil metode AddRef pada antarmuka ITBasicCallControl yang dikembalikan oleh ITAddress::CreateCall. Aplikasi harus memanggil Rilis pada antarmuka ITBasicCallControl ke sumber daya gratis yang terkait dengannya.

Catatan Metode ini tidak sama persis dengan lineMakeCall di TAPI 2. Ini memasok TAPI dengan banyak informasi yang sama, tetapi operasi paralel tidak dilakukan sampai ITBasicCallControl::Connect dipanggil.