lineTranslateDialog 函式 (tapi.h)

發行項
03/02/2024

lineTranslateDialog 函式會顯示應用程式強制回應對話框，讓用戶變更即將撥打的電話號碼目前位置、調整位置和通話卡參數，並查看效果。

語法

LONG lineTranslateDialog(
  HLINEAPP hLineApp,
  DWORD    dwDeviceID,
  DWORD    dwAPIVersion,
  HWND     hwndOwner,
  LPCSTR   lpszAddressIn
);

參數

hLineApp

lineInitializeEx 所傳回的應用程式句柄。如果應用程式尚未呼叫 lineInitializeEx 函式，它可以將 hLineApp 參數設定為零。

dwDeviceID

要撥打呼叫之線路裝置的裝置標識碼，以便將不同行上的撥號程式變化套用至翻譯程式。

dwAPIVersion

應用程式支援的最高 TAPI 版本 (不一定是 dwDeviceID 所指示之線路裝置上 lineNegotiateAPIVersion 所交涉的值) 。

hwndOwner

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

lpszAddressIn

Null 終止字串的指標，其中包含在對話框下半部使用的電話號碼，以顯示使用者對位置參數的變更效果。數字必須是標準格式;如果非標準，則不會顯示對話框的電話號碼部分。此指標可以保留 NULL，在此情況下，不會顯示對話框的電話號碼部分。如果 lpszAddressIn 參數包含子位址或名稱欄位，或是以 CR 和 LF 字元分隔第一個位址的其他位址，則對話框中只會使用第一個位址。

傳回值

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

LINEERR_BADDEVICEID、LINEERR_INVALPARAM、LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_INVALPOINTER、LINEERR_INIFILECORRUPT、LINEERR_NODRIVER、LINEERR_INUSE、LINEERR_NOMEM、LINEERR_INVALADDRESS、LINEERR_INVALAPPHANDLE LINEERR_OPERATIONFAILED。

備註

在 TAPI 2.0 版或更新版本中，可以開啟此對話框的多個實例。在 2.0 之前的 TAPI 版本中，如果另一個應用程式已經顯示對話框，LINEERR_INUSE就會傳回 (它無法開啟超過一次) 。在這些版本中，TAPI 會將現有的對話框帶入前端，而錯誤表示目前應用程式所傳遞位址相關的任何特定專案都尚未處理，因為函式未處理該位址。

應用程式必須在此函式之後呼叫 lineGetTranslateCaps ，以取得使用者對電話語音地址轉譯參數所做的任何變更，並呼叫 lineTranslateAddress 以根據使用者的新選取專案取得可撥號字串。

例如，如果任何與地址轉譯相關的函式 (lineGetTranslateCaps 或 lineTranslateAddress) 傳回LINEERR_INIFILECORRUPT，應用程式應該呼叫 lineTranslateDialog。 lineTranslateDialog 函式會偵測錯誤並加以更正，並回報對使用者所採取的動作。