DOT11EXTIHV_VALIDATE_PROFILE 콜백 함수(wlanihv.h)
구문
DOT11EXTIHV_VALIDATE_PROFILE Dot11extihvValidateProfile;
DWORD Dot11extihvValidateProfile(
[in, optional] HANDLE hIhvExtAdapter,
[in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
[in] PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
[in] PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile,
[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.
[out] pdwReasonCode
Dot11ExtIhvValidateProfile 함수의 반환 값에 대한 추가 정보를 제공하는 DWORD 값에 대한 포인터입니다. IHV 확장 DLL은 * pdwReasonCode 를 L2cmn.h에 정의된 L2_REASON_CODE_xxxx 값으로 설정해야 합니다.
반환 값
호출이 성공하면 함수는 ERROR_SUCCESS 반환합니다. 그렇지 않으면 Winerror.h에 정의된 오류 코드를 반환합니다.
설명
운영 체제는 Dot11ExtIhvValidateProfile 함수를 호출하여 프로필이 처리되거나 저장되기 전에 네트워크 프로필에 대해 사용자가 지정한 설정을 확인합니다.
Dot11ExtIhvValidateProfile 함수가 호출되면 IHV 확장 DLL은 다음 지침을 따릅니다.
- IHV 확장 DLL은 프로필이 적용될 기본 서비스 집합(BSS) 네트워크의 일반 특성에 대해 사용자 지정 프로필 설정이 유효한지 확인합니다. BSS 네트워크 특성은 pIhvProfileParams 매개 변수를 통해 참조됩니다.
- 사용자 데이터가 네트워크 프로필 확장에 유효한 경우 Dot11ExtIhvValidateProfile 은 ERROR_SUCCESS 반환해야 합니다. 그렇지 않으면 함수는 Winerror.h에 정의된 ERROR_xxxx 값에서 적절한 오류 코드를 반환해야 합니다.
-
IHV 확장 DLL은 사용자 데이터의 유효성 검사 결과에 대한 자세한 정보를 제공합니다. DLL은 * pdwReasonCode 를 다음 중 하나로 설정해야 합니다.
- 사용자 데이터가 유효한 경우 L2_REASON_CODE_SUCCESS.
- 사용자 데이터가 유효하지 않은 경우 적절한 L2_REASON_CODE_xxxx 오류 값입니다.
- 사용자 데이터의 유효성에 관계없이 L2_REASON_CODE_IHV_BASE 범위의 IHV 정의 값(L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1)입니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | wlanihv.h(Wlanihv.h, L2cmn.h 포함) |