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 |