ITAddress::CreateCall method (tapi3if.h)
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 |
---|---|
|
Metode berhasil. |
|
Jenis alamat, lAddressType, tidak valid atau menentukan lebih dari satu jenis alamat. |
|
Tidak ada cukup memori untuk melakukan operasi. |
|
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.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Windows |
Header | tapi3if.h (termasuk Tapi3.h) |
Pustaka | Uuid.lib |
DLL | Tapi3.dll |