FaxDevInitialize 函式 (faxdev.h)
傳真服務會在每次服務啟動時呼叫 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 |