функция TSPI_lineGetAddressID (tspi.h)
Функция TSPI_lineGetAddressID возвращает идентификатор адреса, связанный с адресом в другом формате в указанной строке.
Синтаксис
LONG TSPIAPI TSPI_lineGetAddressID(
HDRVLINE hdLine,
LPDWORD lpdwAddressID,
DWORD dwAddressMode,
LPCWSTR lpsAddress,
DWORD dwSize
);
Параметры
hdLine
Дескриптор поставщика услуг к строке, адрес которой требуется извлечь.
lpdwAddressID
Указатель на расположение памяти размера DWORD, в котором возвращается идентификатор адреса.
dwAddressMode
Режим адреса, содержащегося в lpsAddress. Параметр dwAddressMode может иметь одну и только одну из констант LINEADDRESSMODE_.
lpsAddress
Указатель на структуру данных, содержащую адрес, назначенный указанному устройству линии. Формат адреса определяется параметром dwAddressMode . Если это LINEADDRESSMODE_DIALABLEADDR, параметр lpsAddress использует общий формат набираемого номера и имеет значение NULL .
dwSize
Размер адреса, содержащегося в lpsAddress. Параметр dwSize должен иметь длину строки (плюс один для значения NULL), если используется LINEADDRESSMODE_DIALABLEADDR. Если используется расширенный lineADDRESSMODE, длина должна соответствовать размеру передаваемого объекта (библиотека DLL проверяет, может ли она считывать указанное число байтов из заданного указателя).
Возвращаемое значение
Возвращает ноль, если функция выполнена успешно, или номер ошибки при возникновении ошибки. Возможные возвращаемые значения:
LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESS, LINEERR_OPERATIONFAILED, LINEERR_NOMEM LINEERR_RESOURCEUNAVAIL.
Комментарии
Эта функция используется для сопоставления номера телефона (адреса), назначенного устройству линии, с его dwAddressID (в диапазоне от 0 до числа адресов минус один), который возвращается в возможностях устройства линии.
Требования
| Целевая платформа | Windows |
| Header | tspi.h |