DOT11EXTIHV_PERFORM_POST_ASSOCIATE 콜백 함수(wlanihv.h)

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

운영 체제는 Dot11ExtIhvPerformPostAssociate 함수를 호출하여 IHV 확장 DLL이 기본 서비스 집합(BSS) 네트워크와의 연결 후 작업을 시작하도록 요청합니다.

구문

DOT11EXTIHV_PERFORM_POST_ASSOCIATE Dot11extihvPerformPostAssociate;

DWORD Dot11extihvPerformPostAssociate(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] HANDLE hSecuritySessionID,
  [in]           PDOT11_PORT_STATE pPortState,
  [in]           ULONG uDot11AssocParamsBytes,
  [in]           PDOT11_ASSOCIATION_COMPLETION_PARAMETERS pDot11AssocParams
)
{...}

매개 변수

[in, optional] hIhvExtAdapter

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

[in, optional] hSecuritySessionID

보안 세션의 핸들입니다. IHV 확장 DLL은 Dot11ExtPostAssociateCompletion 을 호출하여 연결 후 작업을 비동기적으로 완료할 때 이 핸들 값을 사용해야 합니다.

[in] pPortState

보안 세션의 현재 포트 상태를 지정하는 DOT11_PORT_STATE 구조체에 대한 포인터입니다.

[in] uDot11AssocParamsBytes

pDot11AssocParams 매개 변수를 통해 참조되는 데이터의 길이(바이트)입니다.

[in] pDot11AssocParams

WLAN 어댑터에서 완료한 연결 작업의 결과를 지정하는 DOT11_ASSOCIATION_COMPLETION_PARAMETERS 구조체에 대한 포인터입니다. WLAN 어댑터를 관리하는 Native 802.11 미니포트 드라이버는 미디어별 NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION 표시할 때 DOT11_ASSOCIATION_COMPLETION_PARAMETERS 구조를 포함합니다.

연결 작업에 대한 자세한 내용은 연결 작업을 참조하세요.

반환 값

IHV 확장 DLL이 연결 후 작업을 시작할 수 있는 경우 비동기적으로 작업을 완료해야 합니다. 이 경우 함수는 ERROR_SUCCESS 반환합니다.

IHV 확장 DLL이 연결 후 작업을 시작할 수 없는 경우 Winerror.h에 정의된 오류 코드를 반환합니다.

설명

운영 체제는 Dot11ExtIhvPerformPostAssociate 함수를 호출하여 IHV 확장 DLL과의 연결 후 작업을 시작합니다. 운영 체제는 WLAN 어댑터가 인프라 BSS(기본 서비스 집합) 네트워크에서 AP(액세스 지점)와의 연결 작업을 완료한 후 이 작업을 시작합니다.

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

연결 작업에 대한 자세한 내용은 연결 작업을 참조하세요.

Dot11ExtIhvPerformPostAssociate 호출에서 사후 연결 작업을 비동기적으로 완료해야 합니다. 연결 후 작업이 완료되면 DLL은 Dot11ExtPostAssociateCompletion을 호출해야 합니다.

IHV 확장 DLL이 연결 후 작업을 시작할 수 있는 경우 Dot11ExtIhvPerformPostAssociate 함수는 ERROR_SUCCESS 반환하고 비동기적으로 작업을 완료해야 합니다.

연결 후 작업에 대한 자세한 내용은 연결 후 작업을 참조하세요.

요구 사항

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

참고 항목

Dot11ExtPostAssociateCompletion

Dot11ExtIhvInitAdapter

DOT11_PORT_STATE

Dot11ExtIhvAdapterReset

NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION