Share via

WLAN_CONNECTION_NOTIFICATION_DATA 構造体 (wlanapi.h)

  • [アーティクル]

WLAN_CONNECTION_NOTIFICATION_DATA構造体には、接続関連の通知に関する情報が含まれています。

構文

typedef struct _WLAN_CONNECTION_NOTIFICATION_DATA {
  WLAN_CONNECTION_MODE wlanConnectionMode;
  WCHAR                strProfileName[WLAN_MAX_NAME_LENGTH];
  DOT11_SSID           dot11Ssid;
  DOT11_BSS_TYPE       dot11BssType;
  BOOL                 bSecurityEnabled;
  WLAN_REASON_CODE     wlanReasonCode;
  DWORD                dwFlags;
  WCHAR                strProfileXml[1];
} WLAN_CONNECTION_NOTIFICATION_DATA, *PWLAN_CONNECTION_NOTIFICATION_DATA;

メンバー

wlanConnectionMode

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

WINDOWS XP SP3 とワイヤレス LAN API for Windows XP SP2: wlan_connection_mode_profile値のみがサポートされています。

strProfileName[WLAN_MAX_NAME_LENGTH]

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

dot11Ssid

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

dot11BssType

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

bSecurityEnabled

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

wlanReasonCode

操作が失敗した理由を示す WLAN_REASON_CODE 。 このフィールドには、 wlan_notification_acm_connection_complete を除くすべての接続関連の通知に対して WLAN_REASON_CODE_SUCCESS の値 があります。 接続に失敗した場合、このフィールドは失敗の理由を示します。

dwFlags

ネットワーク接続の追加情報を提供するフラグのセット。

このメンバーには、 Wlanapi.h ヘッダー ファイルで定義されている次のいずれかの値を指定できます。

値 意味
WLAN_CONNECTION_NOTIFICATION_ADHOC_NETWORK_FORMED
 アドホック ネットワークが形成されていることを示します。
WLAN_CONNECTION_NOTIFICATION_CONSOLE_USER_PROFILE
 接続で、コンソール ユーザーが所有するユーザーごとのプロファイルが使用されることを示します。 コンソール以外のユーザーは、プロファイル一覧にプロファイルを表示できません。

strProfileXml[1]

このフィールドには、接続が成功した場合に検出に使用されるプロファイルの XML 表示が含まれます。

注釈

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

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

コールバック関数によって受信したWLAN_NOTIFICATION_DATA構造体の NotificationSource メンバーがWLAN_NOTIFICATION_SOURCE_ACM場合、受信した通知は自動構成モジュール通知になります。 WLAN_NOTIFICATION_CALLBACK関数に渡されるWLAN_NOTIFICATION_DATA構造体の NotificationCode メンバーは、構造体の pData メンバーの解釈WLAN_NOTIFICATION_DATA決定します。 これらの通知の一部では、 WLAN_NOTIFICATION_DATA 構造体の pData メンバーに WLAN_CONNECTION_NOTIFICATION_DATA構造体が 返されます。

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

要件

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

こちらもご覧ください

WLAN_NOTIFICATION_ACM

WLAN_NOTIFICATION_CALLBACK

WLAN_NOTIFICATION_DATA

WlanRegisterNotification