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