LINECARDENTRY 結構 (tapi.h)
LINECARDENTRY 結構描述通話卡。 LINETRANSLATECAPS 結構可以包含LINECARDENTRY結構的陣列。
語法
typedef struct linecardentry_tag {
DWORD dwPermanentCardID;
DWORD dwCardNameSize;
DWORD dwCardNameOffset;
DWORD dwCardNumberDigits;
DWORD dwSameAreaRuleSize;
DWORD dwSameAreaRuleOffset;
DWORD dwLongDistanceRuleSize;
DWORD dwLongDistanceRuleOffset;
DWORD dwInternationalRuleSize;
DWORD dwInternationalRuleOffset;
DWORD dwOptions;
} LINECARDENTRY, *LPLINECARDENTRY;
成員
dwPermanentCardID
識別卡片的永久標識碼。
dwCardNameSize
卡片名稱字串的大小，包括 null 終止符，以位元組為單位。
dwCardNameOffset
從結構的開頭位移到以用戶易記方式描述卡片的 Null 終止字串。 欄位的大小是由 dwCardNameSize 所指定。
dwCardNumberDigits
現有卡片號碼中的位數。 卡片號碼本身不會因為安全性考慮而傳回， (它是由TAPI) 以拼字形式儲存。 應用程式可以使用此選項，將填入 「password」 模式的文字控制件中，以顯示數位存在。
dwSameAreaRuleSize
相同區域撥號規則的大小，包括 null 終止符，以位元組為單位。
dwSameAreaRuleOffset
從 LINETRANSLATECAPS 結構的開頭位移到針對相同區域代碼中號碼呼叫所定義的撥號規則。 規則是 以 Null 結尾的字串。 欄位的大小是由 dwSameAreaRuleSize 所指定。
dwLongDistanceRuleSize
長距離撥號規則的大小，包括 null 終止符，以位元組為單位。
dwLongDistanceRuleOffset
從結構的開頭位移至針對相同國家/地區中其他區域中號碼呼叫所定義的撥號規則。 規則是 以 Null 結尾的字串。 欄位的大小是由 dwLongDistanceRuleSize 所指定。
dwInternationalRuleSize
國際撥號規則的大小，包括 null 終止符，以位元組為單位。
dwInternationalRuleOffset
從結構的開頭位移至針對其他國家/地區號碼呼叫所定義的撥號規則。 規則是 以 Null 結尾的字串。 欄位的大小是由 dwInternationalRuleSize 所指定。
dwOptions
會使用 LINECARDOPTION_ 常數，指出與此通話卡相關聯的其他設定。
備註
舊版應用程式在不知道這些新字段的情況下進行編譯，並使用SIZEOF (LINECARDENTRY) 小於新大小。 因為這是 LINETRANSLATECAPS 結構的變數部分中的數位，所以舊版應用程式必須以先前預期的格式接收 LINECARDENTRY 結構，或無法透過數位正確編製索引。 應用程式會使用 lineGetTranslateCaps 函式傳入 dwAPIVersion 參數，以用於處理這種情況的 TAPI 指引。 lineGetTranslateCaps 函式應該使用符合所指示 API 版本的 LINECARDENTRY 字段和大小，以建置要傳回給應用程式的 LINETRANSLATECAPS 結構。
此結構可能不會延伸。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | tapi.h |