WlanRegisterDeviceServiceNotification 函式 (wlanapi.h)
允許具有系統管理員許可權的使用者模式用戶端,或 User-Mode Driver Framework (UMDF) 驅動程式註冊對應至他們感興趣的裝置服務所對應的未經要求通知。
語法
DWORD WlanRegisterDeviceServiceNotification(
HANDLE hClientHandle,
const PWLAN_DEVICE_SERVICE_GUID_LIST pDevSvcGuidList
);
參數
hClientHandle
類型: HANDLE
用戶端的會話句柄,由先前呼叫 WlanOpenHandle 函式取得。
pDevSvcGuidList
類型: CONST PWLAN_DEVICE_SERVICE_GUID_LIST
常 數WLAN_DEVICE_SERVICE_GUID_LIST 結構的選擇性指標,代表您有興趣接收通知的裝置服務 GUID。 結構的 dwIndex 成員必須小於 其 dwNumberOfItems 成員的值;否則,可能會發生存取違規。 每次呼叫此 API 時,先前的裝置服務列表都會由新裝置取代。
若要取消註冊,請將 pDevSvcGuidList 設定為 nullptr
,或將指標傳遞至已將成員設定為 0 的WLAN_DEVICE_SERVICE_GUID_LIST 結構 dwNumberOfItems
。
傳回值
類型: HRESULT
如果函式成功,傳回值 會ERROR_SUCCESS。 如果函式因 ERROR_ACCESS_DENIED而失敗,則呼叫端沒有足夠的許可權可執行這項作業。 呼叫端必須具有系統管理員許可權,或必須是 UMDF 驅動程式。
備註
WlanRegisterDeviceServiceNotification 函式是 WLAN 裝置服務現有原生 Wi-Fi API 的延伸模組。
用戶端應用程式會呼叫此函式,以註冊和取消註冊它感興趣的裝置服務通知。
如果呼叫的應用程式關閉其呼叫句柄 (,則會透過使用 hClientHandle 參數呼叫 WlanCloseHandle 參數) 呼叫 WlanCloseHandle,自動復原此函式所造成的裝置服務通知的任何註冊。
若要接收這些通知,客戶端必須使用有效的 pDevSvcGuidList 參數呼叫此函式,而且也必須使用 WLAN_NOTIFICATION_SOURCE_DEVICE_SERVICE (的dwNotifSource 自變數呼叫 WlanRegisterNotification 函式,) 中wlanapi.h
定義。 在應用程式透過 hClientHandle 參數呼叫 WlanCloseHandle 參數 () 或進程結束,或以 pDevSvcGuidList 自變數呼叫 WlanCloseHandle,或以 pDevSvcGuidList 自變數nullptr
呼叫 WlanRegisterDeviceServiceNotification,否則會呼叫 WlanRegisterDeviceServiceNotification 的註冊。
當操作系統 (OS) 收到來自獨立硬體廠商的裝置服務通知, (IHV) 驅動程式,而用戶端已使用 WlanRegisterDeviceServiceNotification 註冊這些通知,則用戶端會透過透過其呼叫 WlanRegisterNotification 註冊的WLAN_NOTIFICATION_CALLBACK接收這些通知。 系統會針對用戶端收到每個通知的每個通知呼叫此回呼,每個通知) 都有個別的緩衝區 (。
回呼 (函式所接收之WLAN_NOTIFICATION_DATA結構的 NotificationSource 成員,也就是數據成員) 會設定為WLAN_NOTIFICATION_SOURCE_DEVICE_SERVICE。 數據 Blob、裝置服務 GUID 和與此通知相關聯的 opcode 將會出現在WLAN_NOTIFICATION_DATA的 pData 成員中,這會指向類型為 WLAN_DEVICE_SERVICE_NOTIFICATION_DATA 的結構。
注意
WLAN 服務或 OS 不會檢查裝置服務 GUID是否確實受到 IHV 驅動程式支援。 用戶端最多可以使用 WlanGetSupportedDeviceServices API 來查詢支援的裝置服務。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 10 組建 20348 |
最低支援的伺服器 | Windows 10 組建 20348 |
標頭 | wlanapi.h |
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應