fungsi TSPI_phoneGetExtensionID (tspi.h)

  • Artikel

Fungsi TSPI_phoneGetExtensionID mengambil pengidentifikasi ekstensi yang didukung penyedia layanan untuk perangkat telepon yang ditunjukkan.

Sintaks

LONG TSPIAPI TSPI_phoneGetExtensionID(
  DWORD              dwDeviceID,
  DWORD              dwTSPIVersion,
  LPPHONEEXTENSIONID lpExtensionID
);

Parameter

dwDeviceID

Perangkat telepon yang akan dikueri.

dwTSPIVersion

Menentukan nomor versi antarmuka yang dinegosiasikan untuk perangkat ini menggunakan TSPI_phoneNegotiateTSPIVersion. Fungsi ini beroperasi sesuai dengan spesifikasi antarmuka pada tingkat versi ini.

lpExtensionID

Penunjuk ke struktur jenis PHONEEXTENSIONID. Jika penyedia layanan mendukung ekstensi khusus penyedia, penyedia mengisi struktur ini dengan pengidentifikasi ekstensi ekstensi ini. Jika penyedia layanan tidak mendukung ekstensi, penyedia layanan mengisi struktur ini dengan semua nol. Pengidentifikasi ekstensi dari semua nol bukanlah pengidentifikasi ekstensi hukum, karena nilai all-zeros digunakan untuk menunjukkan bahwa penyedia layanan tidak mendukung ekstensi.

Nilai kembali

Mengembalikan nol jika fungsi berhasil, atau angka kesalahan jika terjadi kesalahan. Kemungkinan nilai yang dikembalikan adalah sebagai berikut:

PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.

Keterangan

Fungsi ini biasanya dipanggil oleh TAPI sebagai respons terhadap aplikasi yang memanggil fungsi phoneNegotiateAPIVersion . Hasil yang dikembalikan oleh penyedia layanan harus sesuai untuk digunakan dalam panggilan berikutnya ke TSPI_phoneNegotiateExtVersion.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header tspi.h

Lihat juga

PHONEEXTENSIONID

TSPI_phoneNegotiateExtVersion

TSPI_phoneNegotiateTSPIVersion