DOT11EXTIHV_PERFORM_CAPABILITY_MATCH 콜백 함수(wlanihv.h)

운영 체제는 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 검사 작업을 참조하세요.

[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 반환해서는 안됩니다.

요구 사항

추가 정보

DOT11EXT_IHV_SECURITY_PROFILE

DOT11_BSS_LIST

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_PROFILE_PARAMS