fungsi lineTranslateAddress (tapi.h)

Artikel
03/02/2024

Fungsi lineTranslateAddress menerjemahkan alamat yang ditentukan ke dalam format lain.

Sintaks

LONG lineTranslateAddress(
  HLINEAPP              hLineApp,
  DWORD                 dwDeviceID,
  DWORD                 dwAPIVersion,
  LPCSTR                lpszAddressIn,
  DWORD                 dwCard,
  DWORD                 dwTranslateOptions,
  LPLINETRANSLATEOUTPUT lpTranslateOutput
);

Parameter

hLineApp

Menangani yang dikembalikan oleh lineInitializeEx. Jika aplikasi TAPI 2.x belum memanggil fungsi lineInitializeEx , aplikasi ini dapat mengatur parameter ini ke NULL. Aplikasi TAPI 1.4 masih harus memanggil lineInitialize terlebih dahulu.

dwDeviceID

Pengidentifikasi perangkat perangkat saluran tempat panggilan akan dihubungi, sehingga variasi dalam prosedur putar nomor pada baris yang berbeda dapat diterapkan ke proses terjemahan.

dwAPIVersion

Versi TERTINGGI TAPI yang didukung oleh aplikasi (belum tentu nilai yang dinegosiasikan oleh lineNegotiateAPIVersion pada beberapa perangkat baris tertentu).

lpszAddressIn

Penunjuk ke string yang dihentikan null yang berisi alamat informasi yang akan diekstrak untuk diterjemahkan. Harus dalam format alamat kanonis, atau string arbitrer digit yang dapat dialabel (non-kanonis). Parameter ini tidak boleh NULL. Jika AddressIn berisi subaddress atau bidang nama, atau alamat tambahan yang dipisahkan dari alamat pertama dengan karakter CR dan LF, hanya alamat pertama yang diterjemahkan.

dwCard

Kartu kredit yang akan digunakan untuk memutar nomor. Parameter ini hanya valid jika bit CARDOVERRIDE diatur dalam dwTranslateOptions. Parameter ini menentukan pengidentifikasi permanen entri Kartu di bagian [Kartu] di registri (seperti yang diperoleh dari lineTranslateCaps) yang harus digunakan alih-alih PreferredCardID yang ditentukan dalam definisi CurrentLocation. Ini tidak menyebabkan parameter PreferredCardID dari entri Lokasi saat ini dalam registri dimodifikasi; penimpaan hanya berlaku untuk operasi terjemahan saat ini. Parameter ini diabaikan jika bit CARDOVERRIDE tidak diatur dalam dwTranslateOptions.

dwTranslateOptions

Operasi terkait yang akan dilakukan sebelum terjemahan alamat ke dalam string yang dapat dialihkan. Parameter ini menggunakan salah satu konstanta LINETRANSLATEOPTION_.

Jika Anda telah mengatur bit LINETRANSLATEOPTION_CANCELCALLWAITING, disarankan juga untuk mengatur bit LINECALLPARAMFLAGS_SECURE di anggota dwCallParamFlags dari struktur LINECALLPARAMS (diteruskan ke lineMakeCall melalui parameter lpCallParams ). Ini mencegah perangkat baris menggunakan digit yang dapat dialihkan untuk menekan interupsi panggilan.

lpTranslateOutput

Pointer ke area memori yang dialokasikan aplikasi untuk berisi output operasi terjemahan, dari jenis LINETRANSLATEOUTPUT. Sebelum memanggil lineTranslateAddress, aplikasi harus mengatur anggota dwTotalSize dari struktur ini untuk menunjukkan jumlah memori yang tersedia untuk TAPI untuk mengembalikan informasi.

Mengembalikan nilai

Mengembalikan nol jika permintaan berhasil atau nomor kesalahan negatif jika terjadi kesalahan. Nilai yang mungkin dikembalikan adalah:

LINEERR_BADDEVICEID, LINEERR_INVALPOINTER, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NODRIVER, LINEERR_INIFILECORRUPT, LINEERR_NOMEM, LINEERR_INVALADDRESS, LINEERR_OPERATIONFAILED, LINEERR_INVALAPPHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCARD, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPARAM.