共用方式為


lineTranslateAddress 函式 (tapi.h)

lineTranslateAddress 函式會將指定的地址轉譯為另一種格式。

語法

LONG lineTranslateAddress(
  HLINEAPP              hLineApp,
  DWORD                 dwDeviceID,
  DWORD                 dwAPIVersion,
  LPCSTR                lpszAddressIn,
  DWORD                 dwCard,
  DWORD                 dwTranslateOptions,
  LPLINETRANSLATEOUTPUT lpTranslateOutput
);

參數

hLineApp

lineInitializeEx 所傳回的句柄。 如果 TAPI 2.x 應用程式尚未呼叫 lineInitializeEx 函式,它可以將此參數設定為 NULL。 TAPI 1.4 應用程式仍必須先呼叫 lineInitialize

dwDeviceID

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

dwAPIVersion

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

lpszAddressIn

Null 終止字串的指標,其中包含要擷取以進行翻譯的信息位址。 必須是標準位址格式,或是可撥號數位的任意字串, (非標準) 。 此參數不得為 NULL。 如果 AddressIn 包含子位址或名稱欄位,或是以 CR 和 LF 字元分隔的第一個位址,則只會轉譯第一個位址。

dwCard

要用於撥號的信用卡。 只有在 DWTranslateOptions 中設定 CARDOVERRIDE 位時,此參數才有效。 此參數指定登錄中 [Card] 區段中卡片專案的永久標識符, (從 lineTranslateCaps 取得,) 應該使用,而不是 CurrentLocation 定義中指定的 PreferredCardID。 它不會修改登錄中目前 Location 專案的 PreferredCardID 參數;覆寫僅適用於目前的翻譯作業。 如果未在 dwTranslateOptions 中設定 CARDOVERRIDE 位,則會忽略此參數。

dwTranslateOptions

將地址轉譯成可撥號字串之前要執行的相關聯作業。 此參數使用其中一個 LINETRANSLATEOPTION_常數

如果您已設定LINETRANSLATEOPTION_CANCELCALLWAITING位,建議您在 LINECALLPARAMS 結構的 dwCallParamFlags 成員中設定LINECALLPARAMFLAGS_SECURE位, (透過 lpCallParams 參數傳遞至 lineMakeCall 參數) 。 這可防止線路裝置使用可撥號數位來隱藏通話中斷。

lpTranslateOutput

應用程式配置的記憶體區域指標,以包含 LINETRANSLATEOUTPUT 類型的轉譯作業輸出。 在呼叫 lineTranslateAddress之前,應用程式必須設定這個結構的 dwTotalSize 成員,以指出TAPI可用來傳回資訊的記憶體數量。

傳回值

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

LINEERR_BADDEVICEID、LINEERR_INVALPOINTER、LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_NODRIVER、LINEERR_INIFILECORRUPT、LINEERR_NOMEM、LINEERR_INVALADDRESS、LINEERR_OPERATIONFAILED、LINEERR_INVALAPPHANDLE、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALCARD、LINEERR_STRUCTURETOOSMALL LINEERR_INVALPARAM。

規格需求

需求
目標平台 Windows
標頭 tapi.h
程式庫 Tapi32.lib
Dll Tapi32.dll

另請參閱

基本電話語音服務參考

標準位址

LINECALLPARAMS

LINETRANSLATEOUTPUT

TAPI 2.2 參考概觀

TAPI 版本交涉

lineInitializeEx

lineNegotiateAPIVersion