WLAN_NOTIFICATION_CALLBACK 콜백 함수(wlanapi.h)

아티클
08/28/2023

WLAN_NOTIFICATION_CALLBACK 콜백 함수 프로토타입은 알림 콜백 함수의 유형을 정의합니다.

구문

WLAN_NOTIFICATION_CALLBACK WlanNotificationCallback;

void WlanNotificationCallback(
  PWLAN_NOTIFICATION_DATA unnamedParam1,
  PVOID unnamedParam2
)
{...}

매개 변수

unnamedParam1

알림 정보를 포함하는 WLAN_NOTIFICATION_DATA 구조체에 대한 포인터입니다.

SP3이 있는 Windows XP 및 SP2를 사용하는 Windows XP용 무선 LAN API: wlan_notification_acm_connection_complete 및 wlan_notification_acm_disconnected 알림만 사용할 수 있습니다.

unnamedParam2

알림에 등록할 때 클라이언트에서 제공하는 컨텍스트 정보에 대한 포인터입니다.

반환 값

없음

설명

WlanRegisterNotification 함수는 애플리케이션에서 모든 무선 인터페이스에서 알림을 등록 및 등록 취소하는 데 사용됩니다. 알림을 등록할 때 애플리케이션은 WlanRegisterNotification 함수에 전달된 funcCallback 매개 변수가 가리키는 콜백 함수를 제공해야 합니다. 이 콜백 함수의 프로토타입은 WLAN_NOTIFICATION_CALLBACK. 이 콜백 함수는 WlanRegisterNotification 함수에 전달된 dwNotifSource 매개 변수에 등록된 알림을 받습니다.

콜백 함수는 알림에 대한 자세한 정보를 포함하는 첫 번째 매개 변수로 WLAN_NOTIFICATION_DATA 구조체에 대한 포인터를 사용하여 호출됩니다. 콜백 함수는 pCallbackContext 매개 변수에서 WlanRegisterNotification 함수에 전달된 클라이언트 컨텍스트에 대한 포인터를 포함하는 두 번째 매개 변수도 수신합니다. WlanRegisterNotification 함수에 전달된 경우 이 클라이언트 컨텍스트는 NULL 포인터가 될 수 있습니다.

등록되면 클라이언트가 핸들을 등록 취소하거나 닫을 때까지 알림을 사용할 수 있을 때마다 콜백 함수가 호출됩니다.

호출 애플리케이션이 WlanRegisterNotification 함수에 알림을 등록하는 데 사용되는 호출 핸들(hClientHandle 매개 변수를 사용하여 WlanCloseHandle을 호출)을 닫거나 프로세스가 종료되는 경우 알림을 받을 등록이 자동으로 취소됩니다.

콜백 함수에서 받은 WLAN_NOTIFICATION_DATA 구조의 NotificationSource 멤버가 WLAN_NOTIFICATION_SOURCE_ACM 경우 수신된 알림은 자동 구성 모듈 알림입니다. WLAN_NOTIFICATION_CALLBACK 함수에 전달된 WLAN_NOTIFICATION_DATA 구조체의 NotificationCode 멤버는 WLAN_NOTIFICATION_DATA구조체의 pData 멤버 해석을 결정합니다. 이러한 알림에 대한 자세한 내용은 WLAN_NOTIFICATION_ACM 열거형 참조를 참조하세요.

콜백 함수에서 수신한 WLAN_NOTIFICATION_DATA 구조의 NotificationSource 멤버가 WLAN_NOTIFICATION_SOURCE_HNWK 경우 수신된 알림은 무선 LAN 서비스가 설치된 Windows 7 및 Windows Server 2008 R2에서 지원되는 무선 호스트 네트워크 알림입니다. WLAN_NOTIFICATION_CALLBACK 함수에 전달된 WLAN_NOTIFICATION_DATA 구조체의 NotificationCode 멤버는 WLAN_NOTIFICATION_DATA구조체의 pData 멤버 해석을 결정합니다. 이러한 알림에 대한 자세한 내용은 WLAN_HOSTED_NETWORK_NOTIFICATION_CODE 열거형 참조를 참조하세요.

콜백 함수에서 받은 WLAN_NOTIFICATION_DATA 구조의 NotificationSource 멤버가 WLAN_NOTIFICATION_SOURCE_IHV 경우 수신된 알림은 IHV(독립 하드웨어 공급업체) 알림입니다. WLAN_NOTIFICATION_CALLBACK 함수에 전달된 WLAN_NOTIFICATION_DATA 구조체의 NotificationCode 멤버는 IHV와 관련된 WLAN_NOTIFICATION_DATA 구조체의 pData 멤버 해석을 결정합니다.

콜백 함수에서 받은 WLAN_NOTIFICATION_DATA 구조의 NotificationSource 멤버가 WLAN_NOTIFICATION_SOURCE_ONEX 경우 수신된 알림은 802.1X 모듈 알림입니다. WLAN_NOTIFICATION_CALLBACK 함수에 전달된 WLAN_NOTIFICATION_DATA 구조체의 NotificationCode 멤버는 WLAN_NOTIFICATION_DATA구조체의 pData 멤버 해석을 결정합니다. 이러한 알림에 대한 자세한 내용은 ONEX_NOTIFICATION_TYPE 열거형 참조를 참조하세요.

콜백 함수에서 받은 WLAN_NOTIFICATION_DATA 구조의 NotificationSource 멤버가 WLAN_NOTIFICATION_SOURCE_MSM 경우 수신된 알림은 MSM(미디어별 모듈) 알림입니다. WLAN_NOTIFICATION_CALLBACK 함수에 전달된 WLAN_NOTIFICATION_DATA 구조체의 NotificationCode 멤버는 WLAN_NOTIFICATION_DATA구조체의 pData 멤버 해석을 결정합니다. 이러한 알림에 대한 자세한 내용은 WLAN_NOTIFICATION_MSM 열거형 참조를 참조하세요.

콜백 함수에서 받은 WLAN_NOTIFICATION_DATA 구조의 NotificationSource 멤버가 WLAN_NOTIFICATION_SOURCE_SECURITY 경우 수신된 알림은 보안 알림입니다. 현재 WLAN_NOTIFICATION_SOURCE_SECURITY 대한 알림이 정의되어 있지 않습니다.

SP3이 있는 Windows XP 및 SP2를 사용하는 Windows XP용 무선 LAN API: 알림은 Netman 서비스에서 처리됩니다. Netman 서비스를 사용하지 않도록 설정하거나 사용할 수 없는 경우 알림이 수신되지 않습니다. 적절한 기간 내에 알림을 받지 못하면 애플리케이션이 시간 초과되고 현재 인터페이스 상태를 쿼리해야 합니다.

요구 사항

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