Поделиться через

Структура 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). Приложение может использовать его для вставки байтов заполнения в текстовый элемент управления в режиме пароля, чтобы показать, что число существует.

dwSameAreaRuleSize

Размер правила набора номера в той же области, включая признак конца NULL , в байтах.

dwSameAreaRuleOffset

Смещение от начала структуры LINETRANSLATECAPS до правила набора номера, определенного для звонков на номера в том же коде города. Правило является строкой, завершающейся null. Размер поля определяется параметром dwSameAreaRuleSize.

dwLongDistanceRuleSize

Размер правила удаленного набора, включая признак конца null , в байтах.

dwLongDistanceRuleOffset

Смещение от начала структуры до правила набора номера, определенного для звонков на номера в других областях в той же стране или регионе. Правило является строкой, завершающейся null. Размер поля определяется dwLongDistanceRuleSize.

dwInternationalRuleSize

Размер международного правила набора, включая признак конца NULL , в байтах.

dwInternationalRuleOffset

Смещение от начала структуры до правила набора номера, определенного для звонков на номера в других странах или регионах. Правило является строкой, завершающейся null. Размер поля определяется параметром dwInternationalRuleSize.

dwOptions

Указывает другие параметры, связанные с этим вызывающим карта, используя константы LINECARDOPTION_.

Комментарии

Старые приложения компилируются без знания этих новых полей и используют размер SIZEOF(LINECARDENTRY) меньше нового размера. Так как это массив в переменной части структуры LINETRANSLATECAPS , крайне важно, чтобы старые приложения получали структуры LINECARDENTRY в формате, который они ожидали ранее, или они не могли правильно индексировать массив. Приложение передает параметр dwAPIVersion с функцией lineGetTranslateCaps , которая может использоваться для указания TAPI при обработке этой ситуации. Функция lineGetTranslateCaps должна использовать поля LINECARDENTRY и размер, соответствующие указанной версии API, при построении структуры LINETRANSLATECAPS , возвращаемой приложению.

Эта структура не может быть расширена.

Требования

Требование Значение
Заголовок tapi.h

См. также раздел

LINETRANSLATECAPS

lineGetTranslateCaps