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

另請參閱

LINETRANSLATECAPS

lineGetTranslateCaps