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

通知の受信に関心があるデバイス サービス GUID を表す定数WLAN_DEVICE_SERVICE_GUID_LIST構造体への省略可能なポインター。 構造体の 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 を呼び出す)、またはプロセスが終了した場合、この関数によって発生したデバイス サービスの通知を受信するための登録は自動的に元に戻されます。

これらの通知を受信するには、クライアントで有効な pDevSvcGuidList パラメーターを使用してこの関数を呼び出す必要があります。また、 で定義wlanapi.hされている) WLAN_NOTIFICATION_SOURCE_DEVICE_SERVICEの dwNotifSource 引数を使用して WlanRegisterNotification 関数を呼び出す必要があります。 デバイス サービスの通知を受信するための登録は、アプリケーションがクライアント ハンドルを閉じる (hClientHandle パラメーターを使用して WlanCloseHandle を呼び出す) か、プロセスが終了するか、WlanRegisterDeviceServiceNotification が pDevSvcGuidList 引数nullptrで呼び出されるか、または dwNumberOfItems が 0 に設定されるまで有効です。

オペレーティング システム (OS) が独立系ハードウェア ベンダー (IHV) ドライバーからデバイス サービス通知を受信し、クライアントが WlanRegisterDeviceServiceNotification を使用してこれらの通知に登録すると、クライアントは WlanRegisterNotification の呼び出しを通じて登録したWLAN_NOTIFICATION_CALLBACKを介してそれらを受信します。 このコールバックは、クライアントが受信したすべての通知に対して呼び出されます (通知ごとに個別のバッファーを使用)。

コールバック関数 (つまり、データ メンバー) によって受信されたWLAN_NOTIFICATION_DATA構造体の NotificationSource メンバーは、WLAN_NOTIFICATION_SOURCE_DEVICE_SERVICEに設定されます。 この通知に関連付けられているデータ BLOB、デバイス サービス GUID、およびオペコードは、WLAN_NOTIFICATION_DATAの pData メンバーに存在し、WLAN_DEVICE_SERVICE_NOTIFICATION_DATA型の構造体を指します。

要件