TSPI_phoneConfigDialog函式 (tspi.h)

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

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

語法

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

參數

dwDeviceID

要設定的電話裝置。

hwndOwner

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

lpszDeviceClass

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

傳回值

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

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

備註

TSPI_phoneConfigDialog 會導致服務提供者將強制回應對話框顯示為 hWndOwner 的子視窗，讓使用者設定 與 dwDeviceID 所指定的手機相關的參數。 lpszDeviceClass 參數可讓應用程式選取適用於使用者感興趣的裝置類別的特定組態信息子畫面。 允許的字串與 TSPI_phoneGetID相同。 例如，如果手機支援 Comm API，將 comm/datamodem 傳遞為 lpszDeviceClass 會導致提供者顯示與 Comm (相關的參數，或至少從多層級組態對話框鏈結中的對應點開始，讓使用者不需要搜尋以尋找所需的參數) 。 szDeviceClass 參數應該是 「tapi/phone」、“” 或 NULL，導致提供者顯示手機的最高層級設定。

此程式必須更新 Win.ini 檔案中的 [Windows Telephony] 區段，WM_WININICHANGE 並在 Telephon.ini 進行任何變更影響應用程式 (例如 PHONECAPS) 或移除手機裝置時，Telephon.ini 訊息。

規格需求

另請參閱

PHONECAPS

TSPI_phoneGetID