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

另请参阅

TSPI_lineNegotiateExtVersion

TSPI_lineNegotiateTSPIVersion