TSPI_lineConfigDialog函式 (tspi.h)

發行項
03/03/2024

TSPI_lineConfigDialog函式已過時。 TAPI 1.4 版或更早版本的服務提供者可以實作此 TSPI 函式。 TAPI 2.0 版或更新版本的 TSP 會實作 TUISPI_lineConfigDialog。

TSPI_lineConfigDialog函式會導致指定行裝置的提供者將強制回應對話框顯示為 hwndOwner 的子視窗，讓使用者設定與線條裝置相關的參數。

語法

LONG TSPIAPI TSPI_lineConfigDialog(
  DWORD  dwDeviceID,
  HWND   hwndOwner,
  LPCSTR lpszDeviceClass
);

參數

dwDeviceID

要設定的線路裝置。

hwndOwner

要放置對話框視窗之父視窗的句柄。

lpszDeviceClass

識別裝置類別名稱 之 Null 終止 Unicode 字串的指標。此裝置類別可讓呼叫端選取適用於該裝置類別之組態資訊的特定子畫面。如果此參數為 NULL 或空字串，則應該選取最高層級組態對話方塊。允許的字串與 TSPI_lineGetID 相同。例如，如果行支援 Comm API，將 comm/datamodem 傳遞為 lpszDeviceClass 會導致提供者顯示與 Comm (相關的參數，或至少從多層級設定對話框鏈結中的對應點開始，讓使用者不需要搜尋以尋找所需的參數。)

傳回值

如果函式成功或發生錯誤，則傳回零。可能的傳回值如下所示：

LINEERR_INUSE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALDEVICECLASS、LINEERR_OPERATIONFAILED、LINEERR_NOMEM LINEERR_RESOURCEUNAVAIL。

備註

此程式必須更新 Win.ini 檔案中的 [Windows Telephony] 區段，並在對 Telephon.ini 檔案進行任何變更時廣播WM_WININICHANGE訊息，這會導致 LINEDEVCAPS 或 LINEADDRESSCAPS 所報告的行或位址功能變更，或是建立或移除線路裝置。

只有關閉行時，才會呼叫此函 式 (TSPI_lineConfigDialog) 沒有限制。不過，每個提供者都可以自行強制執行這類限制。呼叫 TSPI_lineConfigDialog 時，提供者可能會向使用者發出訊息「該行正由一或多個應用程式使用中。當行正在使用時，您可能不會變更行組態」 (，並傳回錯誤訊息LINEERR_INUSE) 。不過，某些組態可能會安全地變更「即時」，特別是與媒體類型相關的設定 (，例如數據機錯誤控制通訊協定) ，特別是在目前未使用該媒體類型時。提供者可以允許在行開啟時變更這些選項。

不允許使用者變更任何改變LINEDEVCAPS或LINEADDRESSCAPS傳回值的任何專案，而不需要先強制關閉這一行做為訊號，應用程式必須呼叫傳回這些結構的函式，才能取得精確的資訊。