функция TSPI_phoneGetExtensionID (tspi.h)
Функция TSPI_phoneGetExtensionID извлекает идентификатор расширения, поддерживаемый поставщиком услуг для указанного телефонного устройства.
Синтаксис
LONG TSPIAPI TSPI_phoneGetExtensionID(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
LPPHONEEXTENSIONID lpExtensionID
);
Параметры
dwDeviceID
Запрашиваемая телефонная устройство.
dwTSPIVersion
Указывает номер версии интерфейса, согласованный для этого устройства с помощью TSPI_phoneNegotiateTSPIVersion. Эта функция работает в соответствии со спецификацией интерфейса на этом уровне версии.
lpExtensionID
Указатель на структуру типа PHONEEXTENSIONID. Если поставщик услуг поддерживает расширения для конкретного поставщика, он заполняет эту структуру идентификатором этих расширений. Если поставщик услуг не поддерживает расширения, он заполняет эту структуру всеми нулями. Идентификатор расширения со всеми нулями не является юридическим идентификатором расширения, так как значение "все нули" используется для указания на то, что поставщик услуг не поддерживает расширения.
Возвращаемое значение
Возвращает ноль, если функция выполнена успешно, или номер ошибки при возникновении ошибки. Возможные возвращаемые значения:
PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM PHONEERR_OPERATIONUNAVAIL.
Комментарии
Эта функция обычно вызывается TAPI в ответ на вызов приложением функции phoneNegotiateAPIVersion . Результат, возвращаемый поставщиком услуг, должен быть подходящим для использования в последующем вызове TSPI_phoneNegotiateExtVersion.
Требования
Требование | Значение |
---|---|
Целевая платформа | Windows |
Header | tspi.h |