WLAN_NOTIFICATION_CALLBACK コールバック関数 (wlanapi.h)

[アーティクル]
08/28/2023

WLAN_NOTIFICATION_CALLBACKコールバック関数プロトタイプは、通知コールバック関数の種類を定義します。

構文

WLAN_NOTIFICATION_CALLBACK WlanNotificationCallback;

void WlanNotificationCallback(
  PWLAN_NOTIFICATION_DATA unnamedParam1,
  PVOID unnamedParam2
)
{...}

パラメーター

unnamedParam1

通知情報を含む WLAN_NOTIFICATION_DATA 構造体へのポインター。

SP3 を使用した Windows XP と、SP2 を使用した Windows XP 用のワイヤレス LAN API: wlan_notification_acm_connection_complete通知とwlan_notification_acm_disconnected通知のみを使用できます。

unnamedParam2

クライアントが通知に登録したときに提供されるコンテキスト情報へのポインター。

戻り値

なし

解説

WlanRegisterNotification 関数は、すべてのワイヤレスインターフェイスで通知を登録および登録解除するためにアプリケーションによって使用されます。通知を登録する場合、アプリケーションは WlanRegisterNotification 関数に渡される funcCallback パラメーターによって指されるコールバック関数を提供する必要があります。このコールバック関数のプロトタイプは 、WLAN_NOTIFICATION_CALLBACKです。このコールバック関数は、WlanRegisterNotification 関数に渡される dwNotifSource パラメーターに登録されている通知を受け取ります。

コールバック関数は、通知に関する詳細情報を含む最初のパラメーターとして、WLAN_NOTIFICATION_DATA 構造体へのポインターを使用して呼び出されます。コールバック関数は、 pCallbackContext パラメーターで WlanRegisterNotification 関数に渡されるクライアントコンテキストへのポインターを含む 2 番目のパラメーターも受け取ります。それが WlanRegisterNotification 関数に渡された場合、このクライアントコンテキストは NULL ポインターにすることができます。

登録されると、クライアントがハンドルの登録を解除または閉じるまで、通知が使用可能になるとコールバック関数が呼び出されます。

通知を受信するための登録は、呼び出し元のアプリケーションが呼び出しハンドルを閉じると (hClientHandle パラメーターを使用して WlanCloseHandle を呼び出すことによって) WlanRegisterNotification 関数への通知の登録に使用される場合、またはプロセスが終了した場合に自動的に元に戻されます。

コールバック関数によって受信されたWLAN_NOTIFICATION_DATA構造体の NotificationSource メンバーがWLAN_NOTIFICATION_SOURCE_ACM場合、受信した通知は自動構成モジュール通知です。 WLAN_NOTIFICATION_CALLBACK関数に渡されるWLAN_NOTIFICATION_DATA構造体の NotificationCode メンバーは、WLAN_NOTIFICATION_DATA構造体の pData メンバーの解釈を決定します。これらの通知の詳細については、「 WLAN_NOTIFICATION_ACM 列挙リファレンス」を参照してください。

コールバック関数によって受信されたWLAN_NOTIFICATION_DATA構造体の NotificationSource メンバーがWLAN_NOTIFICATION_SOURCE_HNWK場合、受信した通知は、ワイヤレス LAN サービスがインストールされた Windows 7 および Windows Server 2008 R2 でサポートされているワイヤレスホスト型ネットワーク通知です。 WLAN_NOTIFICATION_CALLBACK関数に渡されるWLAN_NOTIFICATION_DATA構造体の NotificationCode メンバーは、WLAN_NOTIFICATION_DATA構造体の pData メンバーの解釈を決定します。これらの通知の詳細については、「 WLAN_HOSTED_NETWORK_NOTIFICATION_CODE 列挙リファレンス」を参照してください。

コールバック関数によって受信されたWLAN_NOTIFICATION_DATA構造体の NotificationSource メンバーがWLAN_NOTIFICATION_SOURCE_IHV場合、受信した通知は独立したハードウェアベンダー (IHV) 通知です。 WLAN_NOTIFICATION_CALLBACK関数に渡されるWLAN_NOTIFICATION_DATA構造体の NotificationCode メンバーによって、IHV に固有の WLAN_NOTIFICATION_DATA 構造体の pData メンバーの解釈が決定されます。

コールバック関数によって受信されたWLAN_NOTIFICATION_DATA構造体の NotificationSource メンバーがWLAN_NOTIFICATION_SOURCE_ONEX場合、受信した通知は 802.1X モジュール通知です。 WLAN_NOTIFICATION_CALLBACK関数に渡されるWLAN_NOTIFICATION_DATA構造体の NotificationCode メンバーは、WLAN_NOTIFICATION_DATA構造体の pData メンバーの解釈を決定します。これらの通知の詳細については、「 ONEX_NOTIFICATION_TYPE 列挙リファレンス」を参照してください。

コールバック関数によって受信されたWLAN_NOTIFICATION_DATA構造体の NotificationSource メンバーがWLAN_NOTIFICATION_SOURCE_MSM場合、受信した通知はメディア固有のモジュール (MSM) 通知です。 WLAN_NOTIFICATION_CALLBACK関数に渡されるWLAN_NOTIFICATION_DATA構造体の NotificationCode メンバーは、WLAN_NOTIFICATION_DATA構造体の pData メンバーの解釈を決定します。これらの通知の詳細については、「 WLAN_NOTIFICATION_MSM 列挙リファレンス」を参照してください。

コールバック関数によって受信されたWLAN_NOTIFICATION_DATA構造体の NotificationSource メンバーがWLAN_NOTIFICATION_SOURCE_SECURITY場合、受信した通知はセキュリティ通知です。 現在、WLAN_NOTIFICATION_SOURCE_SECURITYに対する通知は定義されていません。

SP3 を使用した Windows XP と、SP2 を使用した Windows XP 用のワイヤレス LAN API: 通知は Netman サービスによって処理されます。 Netman サービスが無効または使用できない場合、通知は受信されません。通知が妥当な時間内に受信されない場合、アプリケーションはタイムアウトし、現在のインターフェイスの状態を照会する必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista、WINDOWS XP と SP3 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	wlanapi.h
再頒布可能パッケージ	Sp2 を使用した Windows XP 用ワイヤレス LAN API