lineConfigDialogW 函式 (tapi.h)

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

語法

LONG lineConfigDialogW(
  DWORD   dwDeviceID,
  HWND    hwndOwner,
  LPCWSTR 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 相關的參數(或至少從多層次組態對話框鏈結中的對應點開始,因此使用者不需要「挖」來尋找感興趣的參數)。

lpszDeviceClass 參數會是 “tapi/line”、“” 或 NULL,讓提供者顯示該行的最高層級組態。

注意

tapi.h 標頭會將lineConfigDialog定義為別名,根據UNICODE預處理器常數的定義,自動選取此函式的ANSI或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的 慣例。

要求

要求 價值
目標平臺 窗戶
標頭 tapi.h
連結庫 Tapi32.lib
DLL Tapi32.dll

另請參閱

基本電話語音服務參考

TAPI 2.2 參考概觀

lineGetID