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 값입니다.

SP3이 있는 Windows XP 및 SP2를 사용하는 Windows XP용 무선 LAN API: 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 멤버는 WLAN_NOTIFICATION_DATA구조체의 pData 멤버 해석을 결정합니다. 이러한 알림 중 일부의 경우 WLAN_CONNECTION_NOTIFICATION_DATA 구조체가 WLAN_NOTIFICATION_DATA 구조체의 pData 멤버에 반환됩니다.

이러한 알림에 대한 자세한 내용은 WLAN_NOTIFICATION_ACM 열거형 참조를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista, WINDOWS XP SP3 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
머리글	wlanapi.h
재배포 가능 파일	SP2를 사용하는 Windows XP용 무선 LAN API

추가 정보

WLAN_NOTIFICATION_ACM

WLAN_NOTIFICATION_CALLBACK

WLAN_NOTIFICATION_DATA

WlanRegisterNotification