Структура 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 |