lineTranslateAddress 函式 (tapi.h)

發行項
03/05/2024

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。