Структура LINELOCATIONENTRY (tapi.h)
Структура 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 (которая содержит эту запись) до строки с пустым завершением, которая описывает расположение в удобном для пользователя способе.
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, содержащей цифры набора и символы-модификаторы, которые должны быть префиксированы в допускаемую к набору строку (после символа пульса или тона), когда приложение задает бит LINETRANSLATEOPTION_CANCELCALLWAITING в параметре dwTranslateOptionsобъекта lineTranslateAddress. Если префикс не определен, параметру dwCancelCallWaitingSize может быть присвоено значение 0 или 1, а dwCancelCallWaitingOffset может указывать на пустую строку (один байт NULL ).
Комментарии
Эту структуру нельзя расширить.
Старые приложения компилируются без знания этих новых полей и используют sizeOF LINELOCATIONENTRY меньше, чем новый размер. Так как это массив в переменной части структуры LINETRANSLATECAPS , крайне важно, чтобы старые приложения получали структуры LINELOCATIONENTRY в формате, который они ожидали ранее, или они не могли правильно индексировать массив. Приложение передает параметр dwAPIVersion с функцией lineGetTranslateCaps , которая может использоваться для указания TAPI при обработке этой ситуации. Функция lineGetTranslateCaps должна использовать элементы LINELOCATIONENTRY и размер, соответствующие указанной версии API, при создании структуры LINETRANSLATECAPS , возвращаемой в приложение.
Требования
| Требование | Значение |
|---|---|
| Заголовок | tapi.h |