LINETRANSLATEOUTPUT 結構 (tapi.h)

LINETRANSLATEOUTPUT 結構描述地址轉譯的結果。 lineTranslateAddress 函式會使用此結構。

語法

typedef struct linetranslateoutput_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwDialableStringSize;
  DWORD dwDialableStringOffset;
  DWORD dwDisplayableStringSize;
  DWORD dwDisplayableStringOffset;
  DWORD dwCurrentCountry;
  DWORD dwDestCountry;
  DWORD dwTranslateResults;
} LINETRANSLATEOUTPUT, *LPLINETRANSLATEOUTPUT;

成員

dwTotalSize

配置給這個數據結構的大小總計，以位元組為單位。

dwNeededSize

此數據結構需要的大小，以位元組為單位來保存所有傳回的資訊。

dwUsedSize

這個數據結構中包含實用資訊的部分大小，以位元組為單位。

dwDialableStringSize

大小可撥號字串，以位元組為單位，包括終止 的NULL。

dwDialableStringOffset

從這個結構的開頭位移到可傳遞至 lineMakeCall、 lineDial或其他需要可撥號字串之函式的翻譯輸出。 輸出一律為 以 Null 結尾的字串。 如果名稱與子位址等欄位位於輸入字串中，則會包含在此輸出字串中。 此字串可能包含私人資訊，例如通話卡號碼。 不應該向用戶顯示它，以防止不小心看到未經授權的人員。 欄位的大小是由 dwDialableStringSize 所指定。

dwDisplayableStringSize

可向使用者顯示的翻譯輸出大小，包括以位元組為單位的 Null 終止符。

dwDisplayableStringOffset

位移至可向使用者顯示的翻譯輸出，以進行確認。 它與 DialableString 相同，但呼叫卡數位會取代為以括號 (字元括住的易記名稱，例如“[AT&T Card]”) ，以及移除名稱和子地址等輔助字段。 在 dwDisplayableStringOffset 中使用適當的訊息，因為字串可能會在 [呼叫狀態] 對話框中公開顯示。 這項資訊也適合包含在通話記錄中。 欄位的大小是由 dwDisplayableStringSize 所指定。

dwCurrentCountry

在 CurrentLocation 中設定的國家/地區代碼。 此值可用來控制特定使用者介面元素的顯示、本機通話進度音調偵測，以及其他用途。

dwDestCountry

已翻譯位址的目的地國家/地區代碼。 此值可能會傳遞至lineMakeCall和其他撥號函式的 dwCountryCode 參數， (讓目的地國家/地區的呼叫進度音如忙碌訊號正確偵測) 。 如果傳遞至 lineTranslateAddress 的目的地位址不是標準格式，此欄位會設定為零。

dwTranslateResults

衍生自翻譯程序的資訊，可協助應用程式呈現使用者介面元素。 此欄位使用其中一個 LINETRANSLATERESULT_常數。

備註

無法擴充這個結構。

規格需求

需求	值
標頭	tapi.h

另請參閱

lineDial

lineMakeCall

lineTranslateAddress