lineAddProviderA 函式 (tapi.h)

lineAddProvider 函式會將新的電話語音服務提供者安裝到電話語音系統。

語法

LONG lineAddProviderA(
  LPCSTR  lpszProviderFilename,
  HWND    hwndOwner,
  LPDWORD lpdwPermanentProviderID
);

參數

lpszProviderFilename

指標

null 終止的字串，其中包含要加入之服務提供者的路徑。

hwndOwner

處理視窗，其中任何需要顯示為 (安裝程式一部分的對話框，例如，服務提供者的 TSPI_providerInstall 函式) 會附加。可為 NULL ，表示函式期間建立的任何視窗都應該沒有擁有者視窗。

lpdwPermanentProviderID

接收新安裝服務提供者之永久提供者標識碼的變數指標。

傳回值

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

LINEERR_INIFILECORRUPT、LINEERR_INVALPARAM、LINEERR_INVALPOINTER、LINEERR_NOMEM、LINEERR_NOMULTIPLEINSTANCE、LINEERR_OPERATIONFAILED。

備註

在此函式呼叫期間，TAPI 會檢查以確保它可以透過呼叫其 TSPI_providerInstall 函式來存取服務提供者;如果找不到 DLL 或函式 (，或TSPI_providerInstall傳回錯誤 ) ，則此函式會失敗，且提供者不會新增至電話語音系統。如果成功，且 Telephony 系統在一或多個應用程式 (呼叫 lineInitialize 或 lineInitializeEx) ，TAPI 不會嘗試啟動新新增的服務提供者。相反地，為了啟用新的服務提供者，TAPI 會發出訊息以重新啟動 Windows。啟用成功時，應用程式會透過 LINE_CREATE 或 PHONE_CREATE 訊息或要求重新初始化 (的 LINE_LINEDEVSTATE 訊息，通知應用程式是否不支援 CREATE 訊息) 所建立的任何新裝置。

此函式不會複製任何檔案，而不是服務提供者 DLL 本身，也不會複製任何支持的檔案;管理提供者新增的應用程式必須確定提供者已安裝在TAPI (找到的目錄中，例如\WINDOWS、\WINDOWS\SYSTEM 或路徑上的其他位置) 。

注意

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