lineGetProviderListA 函式（tapi.h）

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

語法

LONG lineGetProviderListA(
  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。

注意

tapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 lineGetProviderList 定義為自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

此頁面對您有幫助嗎？