FaxDevInitialize 函式 (faxdev.h)

發行項
08/23/2023

傳真服務會在每次服務啟動時呼叫 FaxDevInitialize 函式，然後載入傳真服務提供者 (FSP) DLL。每個 FSP 都必須匯出 FaxDevInitialize 函式 。

語法

BOOL FaxDevInitialize(
  [in]  HLINEAPP              LineAppHandle,
  [in]  HANDLE                HeapHandle,
  [out] PFAX_LINECALLBACK     *LineCallbackFunction,
  [in]  PFAX_SERVICE_CALLBACK FaxServiceCallback
);

參數

[in] LineAppHandle

類型： HLINEAPP

指定使用 TAPI 註冊傳真服務的控制碼。如需詳細資訊，請參閱 TAPI 2.x lineInitializeEx 函式。

[in] HeapHandle

類型： HANDLE

指定堆積的控制碼，FSP 必須用於所有記憶體配置。

[out] LineCallbackFunction

類型： PFAX_LINECALLBACK*

接收 TAPI 行回呼函式指標的變數指標。

[in] FaxServiceCallback

類型： PFAX_SERVICE_CALLBACK

服務回呼函式的指標。雖然目前未使用此功能，但此功能預期在未來的傳真服務版本中可供使用，並提供從傳真服務到 FSP 的功能。

傳回值

類型： BOOL

如果函式成功，則傳回值是非零值。

如果此函式失敗，則傳回值為零。在此情況下，傳真服務的目前實例不會使用此 FSP。此 FSP 支援的所有裝置都無法傳送或接收傳真。若要取得擴充的錯誤資訊，傳真服務會呼叫 GetLastError。

備註

FSP 必須執行任何必要的初始化，以回應 FaxDevInitialize 函式。

FSP 必須提供LineCallbackFunction參數所指定的FaxLineCallback函式。當傳真服務需要將 TAPI 事件傳遞至 FSP 時，會呼叫此函式。

需求


最低支援的用戶端	Windows 2000 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	faxdev.h