функция TSPI_lineGetExtensionID (tspi.h)
Функция TSPI_lineGetExtensionID возвращает идентификатор расширения, поддерживаемый поставщиком услуг для указанного устройства линии.
Синтаксис
LONG TSPIAPI TSPI_lineGetExtensionID(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
LPLINEEXTENSIONID lpExtensionID
);
Параметры
dwDeviceID
Устройство строки для запроса.
dwTSPIVersion
Номер версии интерфейса, который уже был согласован для этого устройства с помощью TSPI_lineNegotiateTSPIVersion. Эта функция работает в соответствии со спецификацией интерфейса на этом уровне версии.
lpExtensionID
Указатель на структуру типа LINEEXTENSIONID. Если поставщик услуг поддерживает расширения для конкретного поставщика, он заполняет эту структуру идентификатором этих расширений. Если поставщик услуг не поддерживает расширения, он заполняет эту структуру всеми нулями. (Таким образом, допустимый идентификатор расширения не может состоять из всех нулей.)
Возвращаемое значение
Возвращает ноль, если функция выполнена успешно, или номер ошибки при возникновении ошибки. Возможные возвращаемые значения:
LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL LINEERR_RESOURCEUNAVAIL.
Комментарии
Эта функция обычно вызывается TAPI в ответ на то, что приложение вызывает функцию lineNegotiateAPIVersion . Результат, возвращаемый поставщиком услуг, должен быть подходящим для использования в последующем вызове TSPI_lineNegotiateExtVersion. Идентификатор расширения со всеми нулями не является юридическим идентификатором расширения, так как значение all-zeros используется для указания на то, что поставщик услуг не поддерживает расширения.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tspi.h |