TUISPI_lineConfigDialog函式 (tspi.h)

發行項
03/03/2024

TUISPI_lineConfigDialog函式會導致指定行裝置的提供者將強制回應對話框顯示為 hwndOwner 的子視窗，讓使用者設定與線路裝置相關的參數。此函式會使 2.0 版和更新版本中的 TSPI_lineConfigDialog 函式過時， (1.4 版和更早版本) 中支援。

實作是選擇性的。

語法

LONG TSPIAPI TUISPI_lineConfigDialog(
  TUISPIDLLCALLBACK lpfnUIDLLCallback,
  DWORD             dwDeviceID,
  HWND              hwndOwner,
  LPCWSTR           lpszDeviceClass
);

參數

lpfnUIDLLCallback

UI DLL 可以呼叫的函式指標，以與服務提供者 DLL 通訊，以取得顯示對話方塊所需的資訊，以及將更新的組態傳送給服務提供者。

dwDeviceID

要設定的線路裝置。

hwndOwner

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

lpszDeviceClass

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

傳回值

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

LINEERR_INUSE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALDEVICECLASS、LINEERR_OPERATIONFAILED、LINEERR_NOMEM LINEERR_RESOURCEUNAVAIL。

備註

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

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