phoneConfigDialog 函式 (tapi.h)

發行項
03/05/2024

phoneConfigDialog 函式會導致指定電話裝置的提供者顯示強制回應對話框， (附加至應用程式的 hwndOwner 參數) ，讓使用者設定與 dwDeviceID 所指定的電話裝置相關的參數。

語法

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

參數

dwDeviceID

要設定的電話裝置標識碼。

hwndOwner

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

lpszDeviceClass

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

傳回值

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

PHONEERR_BADDEVICEID、PHONEERR_NOMEM、PHONEERR_INUSE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALPARAM、PHONEERR_OPERATIONUNAVAIL、PHONEERR_INVALDEVICECLASS、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALPOINTER PHONEERR_UNINITIALIZED PHONEERR_NODEVICE。

備註

lpszDeviceClass 參數可讓應用程式選取適用於使用者感興趣的裝置類別的特定組態信息子畫面;允許的字串與 phoneGetID 相同。例如，如果手機支援波浪 API，將「wave/in」傳遞為 lpszDeviceClass 會導致提供者顯示與波浪 (相關的參數，或至少從多層級設定對話框鏈結中的對應點開始，而不需要搜尋相關的參數) 。

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