TUISPI_phoneConfigDialog函式 (tspi.h)

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

實作是選擇性的。

語法

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

參數

lpfnUIDLLCallback

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

dwDeviceID

要設定的電話裝置。

hwndOwner

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

lpszDeviceClass

識別裝置類別名稱之 Null 終止 Unicode 字串的指標。 此裝置類別可讓呼叫端選取適用於該裝置類別的特定組態信息子畫面。 如果此參數為 NULL 或空字串，則會選取最高層級的組態對話方塊。

傳回值

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

PHONEERR_BADDEVICEID、PHONEERR_NOMEM、PHONEERR_INUSE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALPARAM、PHONEERR_OPERATIONUNAVAIL、PHONEERR_INVALDEVICECLASS PHONEERR_RESOURCEUNAVAIL。

備註

lpszDeviceClass 參數可讓應用程式選取適用於使用者感興趣的裝置類別的特定組態信息子畫面。 允許的字串與 TSPI_phoneGetID相同。

例如，如果手機支援 Comm API，將 comm/datamodem 傳遞為 lpszDeviceClass 會導致提供者顯示與 Comm (相關的參數，或至少從多層級組態對話框鏈結中的對應點開始，讓使用者不需要搜尋以尋找所需的參數) 。 szDeviceClass 參數應該是 「tapi/phone」、“” 或 NULL，導致提供者顯示手機的最高層級設定。

規格需求

需求	值
目標平台	Windows
標頭	tspi.h

另請參閱

PHONECAPS

TSPI_phoneGetID