fungsi TSPI_providerShutdown (tspi.h)

Artikel
08/26/2023

Fungsi TSPI_providerShutdown mematikan penyedia layanan. Penyedia layanan menghentikan aktivitas apa pun yang sedang berlangsung dan merilis sumber daya apa pun yang telah dialokasikannya.

Sintaks

LONG TSPIAPI TSPI_providerShutdown(
  DWORD dwTSPIVersion,
  DWORD dwPermanentProviderID
);

Parameter

dwTSPIVersion

Versi definisi TSPI tempat fungsi ini harus beroperasi. Pemanggil dapat menggunakan TSPI_lineNegotiateTSPIVersion atau TSPI_phoneNegotiateTSPIVersion dengan INITIALIZE_NEGOTIATION dwDeviceID khusus untuk menegosiasikan versi yang dijamin dapat diterima oleh penyedia layanan.

dwPermanentProviderID

Parameter ini memungkinkan penyedia layanan untuk menentukan mana di antara beberapa kemungkinan instans penyedia layanan yang sedang dimatikan. Nilai parameter identik dengan yang diteruskan dalam parameter dengan nama yang sama di TSPI_providerInit.

Nilai kembali

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

LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM.

Keterangan

Panggilan terakhir yang dipasangkan ke fungsi ini harus menjadi panggilan terakhir ke salah satu fungsi TSPI yang diawali dengan TSPI_line atau TSPI_phone selain TSPI_lineNegotiateTSPIVersion, atau TSPI_phoneNegotiateTSPIVersion. Adalah tanggung jawab pemanggil untuk memastikan hal ini.

Fungsi ini harus selalu berhasil kecuali dalam keadaan luar biasa. Sebagian besar penelepon mungkin akan mengabaikan kode pengembalian karena mereka tidak akan dapat mengimbangi kesalahan apa pun yang terjadi. Nilai pengembalian yang ditentukan lebih penasihat untuk tujuan diagnostik pengembangan daripada yang lain.

Tidak ada fungsi yang sesuai langsung di TAPI. Di TAPI, beberapa instans penggunaan yang berbeda dapat luar biasa, dengan parameter "handel aplikasi" untuk mengidentifikasi instans yang akan dioperasikan. Di TSPI, arsitektur antarmuka hanya mendukung satu instans penggunaan untuk setiap penyedia layanan yang berbeda.