다음을 통해 공유

WlanRegisterVirtualStationNotification 함수(wlanapi.h)

  • 아티클

WlanRegisterVirtualStationNotification 함수는 가상 스테이션에서 알림을 등록 및 등록 취소하는 데 사용됩니다.

구문

DWORD WlanRegisterVirtualStationNotification(
  [in] HANDLE hClientHandle,
  [in] BOOL   bRegister,
       PVOID  pReserved
);

매개 변수

[in] hClientHandle

WlanOpenHandle 함수에 대한 이전 호출에서 얻은 클라이언트의 세션 핸들입니다.

[in] bRegister

가상 스테이션에서 알림을 받을지 여부를 지정하는 값입니다.

pReserved

다음에 사용하도록 예약됩니다. 이 매개 변수는 NULL이어야 합니다.

반환 값

함수가 성공하면 반환 값이 ERROR_SUCCESS.

함수가 실패하면 반환 값은 다음 반환 코드 중 하나일 수 있습니다.

반환 코드 설명
ERROR_INVALID_PARAMETER
 매개 변수가 잘못되었습니다. 다음 조건이 발생하면 이 오류가 반환됩니다.
  • hClientHandle 은 NULL입니다.
  • pvReserved 가 NULL이 아닙니다.
ERROR_INVALID_HANDLE
 핸들이 잘못되었습니다. hClientHandle 매개 변수에 지정된 핸들이 핸들 테이블에 없는 경우 이 오류가 반환됩니다.
ERROR_INVALID_STATE
 리소스가 요청된 작업을 수행하기에 올바른 상태가 아닙니다. 이 오류는 도메인의 그룹 정책에 의해 무선 호스트 네트워크를 사용하지 않도록 설정한 경우 반환됩니다.
ERROR_SERVICE_NOT_ACTIVE
 서비스가 시작되지 않았습니다. WLAN AutoConfig 서비스가 실행되고 있지 않으면 이 오류가 반환됩니다.
기타
 다양한 RPC 및 기타 오류 코드. FormatMessage를 사용하여 반환된 오류에 대한 메시지 문자열을 가져옵니다.

설명

WlanRegisterVirtualStationNotification 함수는 무선 LAN 서비스가 설치된 Windows 7 및 Windows Server 2008 R2에서 무선 호스트 네트워크를 지원하기 위해 추가된 네이티브 무선 API에 대한 확장입니다.

클라이언트 애플리케이션은 WlanRegisterVirtualStationNotification 함수를 호출하여 가상 스테이션에서 알림을 등록 및 등록 취소하는 데 사용됩니다.

호출 애플리케이션이 호출 핸들을 닫거나(hClientHandle 매개 변수를 사용하여 WlanCloseHandle을 호출하여) 프로세스가 종료되는 경우 이 함수로 인한 가상 스테이션에서 알림을 수신하기 위한 모든 등록은 자동으로 실행 취소됩니다.

기본적으로 애플리케이션 클라이언트는 가상 스테이션에서 알림을 받지 않습니다. 이러한 알림을 받으려면 클라이언트는 bRegister 매개 변수가 TRUE로 설정된 WlanRegisterVirtualStationNotification 함수를 호출해야 하며 등록할 알림 원본으로 설정된 dwNotifSource 매개 변수를 사용하여 WlanRegisterNotification 함수를 호출해야 합니다. 가상 스테이션에서 알림을 수신하는 등록은 애플리케이션이 클라이언트 핸들을 닫을 때까지(hClientHandle 매개 변수를 사용하여 WlanCloseHandle을 호출), 프로세스가 종료되거나 bRegister 매개 변수가 FALSE로 설정된 WlanRegisterVirtualStationNotification 함수가 호출될 때까지 적용됩니다.

Windows 7 이상에서 운영 체제는 호스트된 네트워크 지원 무선 어댑터가 컴퓨터에 있는 경우 가상 디바이스를 설치합니다. 이 가상 디바이스는 일반적으로 컴퓨터에 단일 무선 네트워크 어댑터가 있는 경우 디바이스 이름이 'Microsoft Virtual WiFi Miniport 어댑터'인 '무선 네트워크 연결 2'로 "네트워크 연결 폴더"에 표시됩니다. 이 가상 디바이스는 SoftAP(소프트웨어 액세스 지점) 연결을 수행하는 데만 사용되며 WlanEnumInterfaces 함수에서 반환하는 목록에는 없습니다. 이 가상 디바이스의 수명은 실제 무선 어댑터에 연결됩니다. 실제 무선 어댑터를 사용하지 않도록 설정하면 이 가상 디바이스도 제거됩니다. 이 기능은 무선 LAN 서비스가 설치된 Windows Server 2008 R2에서도 사용할 수 있습니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 wlanapi.h(Wlanapi.h 포함)
라이브러리 Wlanapi.lib
DLL Wlanapi.dll

참고 항목

무선 호스트 네트워크 정보

무선 호스팅 네트워크 및 인터넷 연결 공유 사용

WlanCloseHandle

WlanRegisterNotification