lineAddProvider 函式 (tapi.h)

發行項
03/02/2024

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

語法

LONG lineAddProvider(
  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 傳回錯誤) ，則此函式會失敗，而且提供者不會新增至電話語音系統。如果找不到 DLL 或函式，則為失敗。如果成功，而且 Telephony 系統處於作用中狀態， (一或多個應用程式呼叫 lineInitialize 或 lineInitializeEx) ，TAPI 不會嘗試啟動新增的服務提供者。相反地，為了啟用新的服務提供者，TAPI 會發出重新啟動 Windows 的訊息。啟用成功時，如果應用程式不支援 CREATE 訊息，應用程式會透過 LINE_CREATE 或 PHONE_CREATE 訊息，或要求重新初始化 (的 LINE_LINEDEVSTATE 訊息，通知應用程式建立的任何新裝置) 。

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