lineGetProviderList 函式 (tapi.h)

lineGetProviderList函式會傳回目前安裝在電話語音系統中的服務提供者清單。

語法

LONG lineGetProviderList(
  DWORD              dwAPIVersion,
  LPLINEPROVIDERLIST lpProviderList
);

dwAPIVersion

應用程式支援的最高 TAPI 版本 (不一定是某些特定線路裝置上 lineNegotiateAPIVersion 交涉的值) 。

lpProviderList

TAPI 可以傳回 LINEPROVIDERLIST 結構的記憶體位置指標。在呼叫 lineGetProviderList之前，應用程式必須設定此結構的 dwTotalSize 成員，以指出 TAPI 可用來傳回信息的記憶體數量。

注意如果結構中的大小參數不正確，可能會覆寫資料。如需設定結構大小的詳細資訊，請參閱記憶體配置主題。

如果要求成功，則傳回零，如果發生錯誤，則傳回負錯誤號碼。可能的傳回值為：

LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_NOMEM、LINEERR_INIFILECORRUPT、LINEERR_OPERATIONFAILED、LINEERR_INVALPOINTER LINEERR_STRUCTURETOOSMALL。