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 的后续调用。 所有零的扩展标识符不是合法的扩展标识符,因为全零值用于指示服务提供商不支持扩展。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | tspi.h |