DOT11EXTIHV_PERFORM_CAPABILITY_MATCH 콜백 함수(wlanihv.h)

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

운영 체제는 Dot11ExtIhvPerformCapabilityMatch 함수를 호출하여 IHV 확장 DLL이 검색된 BSS(기본 서비스 집합) 네트워크가 IHV에서 정의한 연결 및 보안 프로필 확장과 일치하는지 여부를 결정하도록 요청합니다.

구문

DOT11EXTIHV_PERFORM_CAPABILITY_MATCH Dot11extihvPerformCapabilityMatch;

DWORD Dot11extihvPerformCapabilityMatch(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
  [in]           PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in]           PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile,
  [in, optional] PDOT11_BSS_LIST pConnectableBssid,
  [out]          PDWORD pdwReasonCode
)
{...}

매개 변수

[in, optional] hIhvExtAdapter

IHV 확장 DLL에서 WLAN(무선 LAN) 어댑터를 참조하는 데 사용하는 핸들입니다. 이 핸들 값은 Dot11ExtIhvInitAdapter IHV 처리기 함수에 대한 이전 호출을 통해 지정되었습니다.

[in, optional] pIhvProfileParams

에 대한 포인터입니다. DOT11EXT_IHV_PROFILE_PARAMS 구조체입니다. 이 구조는 프로필 확장이 적용될 BSS(기본 서비스 집합) 네트워크의 특성을 정의합니다.

[in] pIhvConnProfile

에 대한 포인터입니다. IHV 프로필에 대한 연결 설정을 포함하는 DOT11EXT_IHV_CONNECTIVITY_PROFILE 구조체입니다.

[in] pIhvSecProfile

에 대한 포인터입니다. IHV 프로필에 대한 보안 설정을 포함하는 DOT11EXT_IHV_SECURITY_PROFILE 구조체입니다.

[in, optional] pConnectableBssid

BSS 네트워크에서 받은 하나 이상의 802.11 비콘 또는 프로브 응답 프레임을 포함하는 DOT11_BSS_LIST 구조체에 대한 포인터입니다. 이 목록은 WLAN 어댑터에서 수행된 마지막 검사 작업의 결과에서 파생됩니다. 검사 작업에 대한 자세한 내용은 네이티브 802.11 검사 작업을 참조하세요.

참고 Windows Vista의 경우 IHV 확장 DLL은 인프라 BSS(기본 서비스 집합) 네트워크만 지원합니다.

[out] pdwReasonCode

Dot11ExtIhvPerformCapabilityMatch 함수의 반환 값에 대한 추가 정보를 제공하는 DWORD 값에 대한 포인터입니다. IHV 확장 DLL은 * pdwReasonCode 를 L2cmn.h에 정의된 L2_REASON_CODE_xxxx 값으로 설정해야 합니다.

반환 값

802.11 비콘 및 프로브 응답 프레임 목록에 있는 모든 항목이 프로필 조각에 정의된 연결 및 보안 특성을 지원하는 경우 함수는 ERROR_SUCCESS 반환합니다. 그렇지 않으면 Winerror.h에 정의된 오류 코드를 반환합니다.

설명

WLAN 어댑터가 범위 내의 BSS 네트워크를 검색하는 검사 작업을 완료한 후 운영 체제는 Dot11ExtIhvPerformCapabilityMatch 함수를 호출하여 검색된 BSS 네트워크가 IHV에서 정의한 연결 또는 보안 프로필 확장과 일치하는지 여부를 확인할 수 있습니다.

Dot11ExtIhvPerformCapabilityMatch 함수가 호출되면 IHV 확장 DLL은 다음 지침을 따라야 합니다.

  • IHV 확장 DLL이 프로필 조각과 일치하는 하나 이상의 IEEE 802.11 비콘 또는 프로브 응답 프레임을 찾으면 * pdwReasonCode 를 다음 중 하나로 설정해야 합니다.
    • L2_REASON_CODE_SUCCESS.
    • L2_REASON_CODE_IHV_BASE 범위의 IHV 정의 값입니다(L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).
    이 경우 Dot11ExtIhvPerformCapabilityMatch 함수는 ERROR_SUCCESS 반환해야 합니다.
  • IHV 확장 DLL이 프로필 조각과 일치하는 IEEE 802.11 비콘 또는 프로브 응답 프레임을 찾지 못하는 경우 *pdwReasonCode 를 L2_REASON_CODE_SUCCESS 설정해서는 안 됩니다. 대신 DLL은 * pdwReasonCode 를 다음 중 하나로 설정해야 합니다.
    • 적절한 L2_REASON_CODE_xxxx 오류 값입니다.
    • L2_REASON_CODE_IHV_BASE 범위의 IHV 정의 값입니다(L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).
    이 경우 Dot11ExtIhvPerformCapabilityMatch 함수는 ERROR_SUCCESS 반환해서는 안됩니다.
Native 802.11 XML 스키마에 대한 자세한 내용은 Microsoft Windows SDK 설명서를 참조하세요.

요구 사항

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

추가 정보

DOT11EXT_IHV_CONNECTIVITY_PROFILE

DOT11EXT_IHV_SECURITY_PROFILE

DOT11_BSS_LIST

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_PROFILE_PARAMS