lineConfigDialog 函式 (tapi.h)

發行項
03/02/2024

lineConfigDialog 函式會讓指定行裝置的提供者顯示對話框， (附加至應用程式的 hwndOwner) ，讓使用者設定與線路裝置相關的參數。

語法

LONG lineConfigDialog(
  DWORD  dwDeviceID,
  HWND   hwndOwner,
  LPCSTR lpszDeviceClass
);

參數

dwDeviceID

要設定之線路裝置的標識碼。

hwndOwner

要附加對話框的視窗句柄。可為 NULL ，表示函式期間建立的任何視窗都應該沒有擁有者視窗。

lpszDeviceClass

識別裝置類別名稱之 Null 終止字串的指標。此裝置類別可讓應用程式選取適用於該裝置類別的特定組態信息子畫面。此參數是選擇性的，而且可以保留 NULL 或空白，在此情況下，會選取最高層級組態。

傳回值

如果要求成功或發生錯誤，則傳回零。可能的傳回值為：

LINEERR_BADDEVICEID、LINEERR_NOMEM、LINEERR_INUSE、LINEERR_OPERATIONFAILED、LINEERR_INVALDEVICECLASS、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPARAM、LINEERR_UNINITIALIZED、LINEERR_INVALPOINTER、LINEERR_OPERATIONUNAVAIL LINEERR_NODEVICE。

備註

lineConfigDialog 函式會使服務提供者顯示強制回應對話框， (附加至應用程式的 hwndOwner) ，讓使用者設定與 dwDeviceID 所指定行相關的參數。 lpszDeviceClass 參數可讓應用程式選取適用於使用者感興趣的裝置類別的特定組態信息子畫面;允許的字串與lineGetID相同。例如，如果行支援 Comm API，將「COMM」傳遞為 lpszDeviceClass 會導致提供者顯示與 Comm (相關的參數，或至少從多層級設定對話框鏈結中的對應點開始，因此使用者不需要「dig」來尋找感興趣的參數) 。

lpszDeviceClass 參數會是 “tapi/line”、“ ”“ 或 NULL，導致提供者顯示該行的最高層級設定。