FaxExtRegisterForEvents 函式 (faxext.h)
FaxExtRegisterForEvents回呼函式會註冊傳真延伸模組 DLL，以取得與特定裝置和 GUID 相關的設定資料變更通知。
語法
HANDLE FaxExtRegisterForEvents(
[in] HINSTANCE hInst,
[in] DWORD dwDeviceId,
[in] FAX_ENUM_DEVICE_ID_SOURCE DevIdSrc,
[in] LPCWSTR lpcwstrDataGUID,
[in] PFAX_EXT_CONFIG_CHANGE lpConfigChangeCallback
);
參數
[in] hInst
類型： HINSTANCE
指定 HINSTANCE 值，識別要求通知的傳真延伸模組 DLL 實例。 傳真服務會使用此值來防止傳送有關資料變更之相同延伸模組之資料變更的通知。
[in] dwDeviceId
類型： DWORD
指定 DWORD 值，指出應該傳送通知的裝置。
此參數可以是零，表示傳真服務應該傳送有關通用群組態資料變更的通知，也就是與特定裝置無關的組態資料。 如需詳細資訊，請參閱 儲存全域設定資料。
[in] DevIdSrc
類型： FAX_ENUM_DEVICE_ID_SOURCE
指定 dwDeviceId 參數的來源。 此參數可以有下列其中一個值。
DEV_ID_SRC_FAX (DEV_ID_SRC_FAX)
dwDeviceId參數是由傳真服務或虛擬 FSP 產生。 傳真路由延伸模組和虛擬 FSP 應該使用此值。
DEV_ID_SRC_TAPI (DEV_ID_SRC_TAPI)
dwDeviceId參數是由 TAPI TSP 所產生。 以 TAPI 為基礎的 FSP 應該使用此值。
[in] lpcwstrDataGUID
類型： LPCWSTR
常數 Null 終止的 Unicode 字元字串指標，指定應該傳送通知之資料的 GUID;例如，「{b8959fc9-4e77-4ee9-8411-009acb1bbf3e}」。
[in] lpConfigChangeCallback
類型： LPBYTE
傳真延伸模組 DLL 中定義的 FaxExtConfigChange 回呼函式指標。 傳真服務會呼叫此函式，以通知傳真延伸模組有關設定資料變更。
傳回值
類型： HANDLE
如果函式成功，則傳回值為通知 HANDLE。
如果函式失敗，則傳回值為 Null。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
FaxExtRegisterForEvents函式可以傳回下列錯誤碼。
| 傳回碼 | 描述 |
|---|---|
|
傳遞至函式的至少一個參數無效。 |
|
伺服器在傳送有關資料變更的通知時，無法處理通知的要求。 您應該稍後嘗試呼叫 函式。 |
|
此延伸模組已要求此裝置識別碼和 GUID 的設定資料變更相關通知。 |
|
可用的記憶體不足，無法完成作業。 |
|
傳真伺服器的內部失敗會防止存取資料。 |
|
伺服器正在關閉。 |
備註
當傳真延伸模組呼叫此傳真服務回呼函式時，它必須使用傳真服務呼叫 FaxExtInitializeConfig 函式時所公開的函式指標。
安全性需求： 呼叫端必須具有存取權，才能查詢伺服器的組態，才能呼叫此函式。
如果擴充功能註冊以接收有關設定資料變更的通知，則延伸模組不會收到其設定本身之新組態值的通知。
傳真延伸模組可以註冊，以接收稍後將存在之裝置識別碼和 GUID 之資料變更的相關通知。 一旦裝置識別碼和 GUID 接收資料，傳真服務就會發出變更通知。 您也可以將組態資料儲存在 (，也就是呼叫 傳真ExtSetData 函式) ，以供尚未存在的裝置使用。
當傳真服務呼叫FaxExtInitializeConfig函式時，傳真服務會將指標傳遞給FaxExtRegisterForEvents回呼函式。 PFAX_EXT_REGISTER_FOR_EVENTS資料類型是 FaxExtRegisterForEvents 函 式的指標。
FaxExtUnregisterForEvents回呼函式會取消註冊傳真延伸模組 DLL，以取得與特定裝置和 GUID 相關的全域設定資料變更或設定資料變更的相關通知。
應用程式可以藉由呼叫 FaxExtSetData 函式，變更與特定傳真裝置相關聯的通用群組態資料或資料。
需求
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | faxext.h |