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