METODE ITBasicCallControl::D ial (tapi3if.h)

Artikel
03/02/2024

Metode Putar nomor memanggil alamat yang ditentukan.

Sintaks

HRESULT Dial(
  [in] BSTR pDestAddress
);

Parameter

[in] pDestAddress

Penunjuk ke representasi BSTR alamat yang akan dihubungi. Format harus sesuai dengan alamat standar yang dapat dialihkan.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Makna
S_OK	Metode berhasil.
E_OUTOFMEMORY	Tidak ada cukup memori untuk melakukan operasi.
E_POINTER	Parameter pDestAddress bukan penunjuk yang valid.
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 pDestAddress dan menggunakan SysFreeString untuk membebaskan memori ketika variabel tidak lagi diperlukan.

Dalam beberapa kasus, aplikasi mungkin perlu menggunakan antarmuka terjemahan alamat ( ITAddressTranslation dan ITAddressTranslationInfo) untuk mendapatkan string pDestAddress dalam format yang tepat.

Metode Putar nomor berbeda dari ITAddress::CreateCall karena panggilan sudah ada. Contoh penggunaannya adalah memutar nomor ekstensi.