Share via

DOT11EXT_SET_CURRENT_PROFILE 콜백 함수(wlanihv.h)

  • 아티클
중요Native 802.11 무선 LAN 인터페이스는 Windows 10 이상에서 더 이상 사용되지 않습니다. 대신 WLAN WDI(디바이스 드라이버 인터페이스)를 사용하세요. WDI에 대한 자세한 내용은 WLAN 유니버설 Windows 드라이버 모델을 참조하세요.
 
IHV 확장 DLL은 Dot11ExtSetCurrentProfile 함수를 호출하여 IHV 정의 연결 및 보안 프로필 조각에 대한 설정을 지정합니다. 이러한 조각은 현재 네트워크 프로필에 적용됩니다.

구문

DOT11EXT_SET_CURRENT_PROFILE Dot11extSetCurrentProfile;

DWORD Dot11extSetCurrentProfile(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in, optional] PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in, optional] PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile
)
{...}

매개 변수

[in, optional] hDot11SvcHandle

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

[in, optional] hConnectSession

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

[in, optional] pIhvConnProfile

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

[in, optional] pIhvSecProfile

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

반환 값

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

설명

Dot11ExtSetCurrentProfile 함수를 사용하면 IHV가 BSS(기본 서비스 집합) 네트워크 연결에 사용되는 현재 네트워크 프로필에 사용자 지정 연결 및 보안 프로필 조각을 추가할 수 있습니다. 프로필 조각은 IHV에 따라 다르며 네이티브 802.11 IHV UI 확장 DLL을 통해 사용자가 사용할 수 있는 연결 또는 보안 확장에 적용됩니다.

IHV 확장 DLL은 Dot11ExtSetCurrentProfile 함수를 호출할 때 다음 지침을 따라야 합니다.

  • IHV 확장 DLL은 에 대한 호출을 통해 시작된 사전 연결 작업을 수행할 때만 Dot11ExtSetCurrentProfile 을 호출해야 합니다. Dot11ExtIhvPerformPreAssociate IHV 처리기 함수입니다. 사전 연결 작업에 대한 자세한 내용은 사전 연결 작업을 참조하세요.
  • IHV 확장 DLL은 에 대한 호출 내에서 Dot11ExtSetCurrentProfile 을 호출해서는 안 됩니다. Dot11ExtIhvPerformPreAssociate IHV 처리기 함수입니다. Dot11ExtSetCurrentProfile 은 Dot11ExtIhvPerformPreAssociate에 대한 호출을 처리하는 스레드와 다른 스레드에서 호출되어야 합니다.

요구 사항

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

추가 정보

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_SECURITY_PROFILE

Dot11ExtIhvPerformPreAssociate DOT11EXT_IHV_CONNECTIVITY_PROFILE