lineGetProviderList 函数 (tapi.h)

lineGetProviderList 函数返回当前安装在电话系统中的服务提供商列表。

语法

LONG lineGetProviderList(
  DWORD              dwAPIVersion,
  LPLINEPROVIDERLIST lpProviderList
);

dwAPIVersion

应用程序支持的 TAPI 的最高版本 (不一定是 lineNegotiateAPIVersion 在某些特定线路设备上) 协商的值。

lpProviderList

指向 TAPI 可以返回 LINEPROVIDERLIST 结构的内存位置的指针。在调用 lineGetProviderList 之前，应用程序必须设置此结构的 dwTotalSize 成员，以指示 TAPI 可用于返回信息的内存量。

注意如果结构中的 size 参数不正确，则有可能覆盖数据。有关设置结构大小的详细信息，请参阅内存分配主题。

如果请求成功，则返回零;如果发生错误，则返回负错误号。可能的返回值为：

LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_NOMEM、LINEERR_INIFILECORRUPT、LINEERR_OPERATIONFAILED、LINEERR_INVALPOINTER、LINEERR_STRUCTURETOOSMALL。