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 |