lineTranslateDialogW 函式（tapi.h）

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

語法

LONG lineTranslateDialogW(
  HLINEAPP hLineApp,
  DWORD    dwDeviceID,
  DWORD    dwAPIVersion,
  HWND     hwndOwner,
  LPCWSTR  lpszAddressIn
);

參數

hLineApp

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

dwDeviceID

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

dwAPIVersion

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

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 函式會偵測錯誤並加以更正，並回報對使用者採取的動作。

注意

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