WLAN_MSM_NOTIFICATION_DATA構造体 (wlanapi.h)

WLAN_MSM_NOTIFICATION_DATA構造体には、メディア固有モジュール (MSM) 接続関連の通知に関する情報が含まれています。

構文

typedef struct _WLAN_MSM_NOTIFICATION_DATA {
  WLAN_CONNECTION_MODE wlanConnectionMode;
  WCHAR                strProfileName[WLAN_MAX_NAME_LENGTH];
  DOT11_SSID           dot11Ssid;
  DOT11_BSS_TYPE       dot11BssType;
  DOT11_MAC_ADDRESS    dot11MacAddr;
  BOOL                 bSecurityEnabled;
  BOOL                 bFirstPeer;
  BOOL                 bLastPeer;
  WLAN_REASON_CODE     wlanReasonCode;
} WLAN_MSM_NOTIFICATION_DATA, *PWLAN_MSM_NOTIFICATION_DATA;

メンバー

wlanConnectionMode

接続のモードを指定する WLAN_CONNECTION_MODE 値。

strProfileName[WLAN_MAX_NAME_LENGTH]

接続に使用されるプロファイルの名前。 WLAN_MAX_NAME_LENGTHは 256 です。 プロファイル名では大文字と小文字が区別されます。 この文字列は NULL で終わる必要があります。

dot11Ssid

関連付けの SSID を含む DOT11_SSID 構造体。

dot11BssType

BSS ネットワークの種類を示す DOT11_BSS_TYPE 値。

dot11MacAddr

ピアまたはアクセス ポイントの MAC アドレスを指定するDOT11_MAC_ADDRESS。

bSecurityEnabled

この接続に対してセキュリティが有効かどうかを示します。 TRUE の場合、セキュリティが有効になります。

bFirstPeer

マシンによって作成されたアドホック ネットワークにピアが最初に参加するかどうかを示します。 TRUE の場合、ピアは最初に参加します。

最初のピアがネットワークに参加すると、アドホック ネットワークを作成したマシンのインターフェイスの状態がwlan_interface_state_ad_hoc_network_formedからwlan_interface_state_connectedに変わります。

bLastPeer

マシンによって作成されたアドホック ネットワークをピアが最後に残すかどうかを示します。 TRUE の場合、ピアは最後に終了します。 最後のピアがネットワークを離れると、アドホック ネットワークを作成したマシンのインターフェイスの状態がwlan_interface_state_connectedからwlan_interface_state_ad_hoc_network_formedに変わります。

wlanReasonCode

操作エラーの理由を示す WLAN_REASON_CODE 。 操作が成功した場合、このフィールドの値は WLAN_REASON_CODE_SUCCESS。 それ以外の場合、このフィールドはエラーの理由を示します。

解説

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

コールバック関数は、通知に関する詳細情報を含む最初のパラメーターとして 、WLAN_NOTIFICATION_DATA 構造体へのポインターを使用して呼び出されます。

コールバック関数によって受信されたWLAN_NOTIFICATION_DATA構造体の NotificationSource メンバーがWLAN_NOTIFICATION_SOURCE_MSM場合、受信した通知はメディア固有のモジュール (MSM) 通知です。 WLAN_NOTIFICATION_CALLBACK関数に渡されるWLAN_NOTIFICATION_DATA構造体の NotificationCode メンバーは、WLAN_NOTIFICATION_DATA構造体の pData メンバーの解釈決定します。 これらの通知の一部では、WLAN_MSM_NOTIFICATION_DATA構造体が WLAN_NOTIFICATION_DATA 構造体のpData メンバーで返されます。

これらの通知の詳細については、「 WLAN_NOTIFICATION_MSM 列挙リファレンス」を参照してください。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
Header wlanapi.h

関連項目

WLAN_NOTIFICATION_CALLBACK

WLAN_NOTIFICATION_DATA

WLAN_NOTIFICATION_MSM

WlanRegisterNotification