DOT11EXT_SET_VIRTUAL_STATION_AP_PROPERTIES 콜백 함수(wlanihv.h)

  • 아티클
중요Native 802.11 무선 LAN 인터페이스는 Windows 10 이상에서 더 이상 사용되지 않습니다. 대신 WLAN WDI(디바이스 드라이버 인터페이스)를 사용하세요. WDI에 대한 자세한 내용은 WLAN 유니버설 Windows 드라이버 모델을 참조하세요.

IHV 확장 DLL은 Dot11ExtSetVirtualStationAPProperties 함수를 호출하여 현재 IHV 프로필 연결을 지정합니다.

구문

DOT11EXT_SET_VIRTUAL_STATION_AP_PROPERTIES Dot11extSetVirtualStationApProperties;

DWORD Dot11extSetVirtualStationApProperties(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in]           DWORD dwNumProperties,
  [in]           PDOT11EXT_VIRTUAL_STATION_AP_PROPERTY pProperties,
                 LPVOID pvReserved
)
{...}

매개 변수

[in, optional] hDot11SvcHandle

운영 체제에서 기본 WLAN(물리적 무선 LAN) 어댑터를 참조하는 데 사용하는 선택적 핸들입니다. 이 핸들 값은 Dot11ExtIhvInitAdapter IHV 처리기 함수에 대한 이전 호출을 통해 hDot11SvcHandle 매개 변수로 수신되었습니다.

[in, optional] hConnectSession

운영 체제에서 BSS(기본 서비스 집합) 네트워크를 사용하여 현재 연결 세션을 참조하는 데 사용하는 핸들입니다. 이 핸들 값은 에 대한 이전 호출을 통해 hConnectSession 매개 변수로 수신되었습니다. Dot11ExtIhvPerformPreAssociate IHV 처리기 함수입니다.

[in] dwNumProperties

pProperties 매개 변수가 가리키는 구조체 배열의 요소 수입니다.

[in] pProperties

배열에 대한 포인터입니다. 가상 802.11 스테이션이 현재 연결 세션에서 호스트하려고 시도하는 액세스 지점(PS)의 속성을 지정하는 구조체를 DOT11EXT_VIRTUAL_STATION_AP_PROPERTY.

pvReserved

이 매개 변수는 운영 체제에서 사용하도록 예약되어 있으며 NULL이어야 합니다.

반환 값

호출이 성공하면 함수는 ERROR_SUCCESS 반환합니다. 그렇지 않으면 Winerror.h에 정의된 오류 코드를 반환합니다.

설명

현재 IHV 프로필 연결이 AP(액세스 지점)이고 IHV 확장 DLL이 운영 체제에 AP에서 사용하는 설정을 제공할 수 있는 경우 운영 체제는 운영 체제에서 AP 관련 서비스를 요청하는 사용자에게 추가 정보를 제공할 수 있습니다.

IHV 확장 DLL이 Dot11ExtSetVirtualStationAPProperties를 호출하는 경우 를 호출하기 전에 이 작업을 수행해야 합니다. Dot11ExtIhvPerformPreAssociate IHV 처리기 함수입니다. 사전 연결 작업을 성공적으로 완료하기 전에 Dot11ExtSetVirtualStationAPProperties 가 호출되지 않은 경우 운영 체제는 IHV 프로필의 특성에 대해 가정하지 않습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼 데스크톱
머리글 wlanihv.h(Wlanihv.h 포함)

추가 정보

Dot11ExtIhvPerformPreAssociate

Dot11ExtIhvInitAdapter

DOT11EXT_VIRTUAL_STATION_AP_PROPERTY