tapi.h (LINELOCATIONENTRY 結構)
LINELOCATIONENTRY 結構描述用來提供地址轉譯內容的位置。 LINETRANSLATECAPS 結構可以包含LINELOCATIONENTRY結構的數位。
語法
typedef struct linelocationentry_tag {
DWORD dwPermanentLocationID;
DWORD dwLocationNameSize;
DWORD dwLocationNameOffset;
DWORD dwCountryCode;
DWORD dwCityCodeSize;
DWORD dwCityCodeOffset;
DWORD dwPreferredCardID;
DWORD dwLocalAccessCodeSize;
DWORD dwLocalAccessCodeOffset;
DWORD dwLongDistanceAccessCodeSize;
DWORD dwLongDistanceAccessCodeOffset;
DWORD dwTollPrefixListSize;
DWORD dwTollPrefixListOffset;
DWORD dwCountryID;
DWORD dwOptions;
DWORD dwCancelCallWaitingSize;
DWORD dwCancelCallWaitingOffset;
} LINELOCATIONENTRY, *LPLINELOCATIONENTRY;
成員
dwPermanentLocationID
永久。 識別位置。
dwLocationNameSize
大小，以字元為單位，包含 Null 終止字元的 Null 終止位置名稱字串。
dwLocationNameOffset
在 dwLocationNameSize 中指定的位移大小，從 LINETRANSLATECAPS 結構的開頭 (包含這個專案) 到以使用者易記方式描述位置的 Null 終止字元串。
dwCountryCode
位置的國家或地區代碼。
dwCityCodeSize
Null 終止城市代碼 字串的大小，以字元為單位，包括 Null 終止字元。
dwCityCodeOffset
dwCityCodeSize 中指定的位移，從這個 結構的開頭到以 Null 結尾的字串，指定與位置相關聯的城市/區域代碼。 使用國家或地區代碼，應用程式可以在輸入電話號碼時使用這項資訊來「預設」輸入欄位給使用者，以鼓勵輸入適當的標準號碼。
dwPreferredCardID
從這個位置撥號時，慣用的通話卡。
dwLocalAccessCodeSize
本機存取代碼字串的大小，以位元組為單位，包括 Null 終止符。
dwLocalAccessCodeOffset
dwLocalAccessCodeSize 中指定的位移大小，從 LINETRANSLATECAPS 結構的開頭到 Null 終止的字串，其中包含在呼叫本機呼叫區域中位址之前要撥號的存取碼。
dwLongDistanceAccessCodeSize
長距離訪問碼的大小，以位元組為單位，包括 Null 終止符。
dwLongDistanceAccessCodeOffset
在 dwLongDistanceAccessCodeSize 中指定的位移大小，從 LINETRANSLATECAPS 結構的開頭到 Null 終止的字串，其中包含在呼叫區域外部位址之前要撥號的存取碼。
dwTollPrefixListSize
收費前綴的大小，以位元組為單位，包括 Null 終止符。
dwTollPrefixListOffset
在 dwTollPrefixListSize 中指定的位移大小，從 LINETRANSLATECAPS 結構的開頭到包含位置收費前綴清單的 Null 終止字串。 字串只包含包含數位 「0」 到 「9」 的前置詞，並以單一 “，” (逗號) 字元彼此分隔。
dwCountryID
為位置選取的國家/地區標識符。 這可以與 lineGetCountry 函式搭配使用，以取得特定國家/地區的其他資訊，例如國家/地區名稱 (dwCountryCode 成員無法用於此用途，因為國家/地區代碼不是唯一) 。
dwOptions
此位置生效的選項，具有取自 LINELOCATIONOPTION_ 常數的值。
dwCancelCallWaitingSize
取消呼叫等候字串的大小，以位元組為單位。
dwCancelCallWaitingOffset
在 dwCancelCallWaitingSize 中指定的位移大小，從 LINETRANSLATECAPS 結構的開頭到 Null 終止的字串，其中包含在 lineTranslateAddress 的 dwTranslateOptions 參數中設定LINETRANSLATEOPTION_CANCELCALLWAITING位時，應該前置至可撥號字元串 (的可撥號) 字串 (字符。 如果未定義前置詞， dwCancelCallWaitingSize 可能會設定為零，或 1， 而 dwCancelCallWaitingOffset 可能會指向單一 NULL 位元組) 的空字元串 (。
備註
無法擴充這個結構。
舊版應用程式會在不知道這些新字段的情況下進行編譯，並使用小於新大小的 SIZEOF LINELOCATIONENTRY。 因為這是 LINETRANSLATECAPS 結構的變數部分中的陣列，所以舊版應用程式必須以先前預期的格式接收 LINELOCATIONENTRY 結構，或無法正確地透過數位編制索引。 應用程式會使用 lineGetTranslateCaps 函式傳入 dwAPIVersion 參數，此函式可用於 TAPI 處理這種情況的指引。 當建置要傳回給應用程式的 LINETRANSLATECAPS 結構時，lineGetTranslateCaps 函式應該使用符合所指示 API 版本的 LINELOCATIONENTRY 成員和大小。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | tapi.h |