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 |
标头 | tspi.h |