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 ヘッダー ファイルで定義されている次のいずれかの値を指定できます。
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 |