DOT11EXT_POST_ASSOCIATE_COMPLETION 콜백 함수(wlanihv.h)

아티클
02/07/2025

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

IHV 확장 DLL은 Dot11ExtPostAssociateCompletion 함수를 호출하여 다음 호출을 통해 시작된 연결 후 작업을 비동기적으로 완료합니다. Dot11ExtIhvPerformPostAssociate IHV 처리기 함수입니다.

통사론

DOT11EXT_POST_ASSOCIATE_COMPLETION Dot11extPostAssociateCompletion;

DWORD Dot11extPostAssociateCompletion(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hSecuritySessionID,
  [in, optional] PDOT11_MAC_ADDRESS pPeer,
  [in]           DWORD dwReasonCode,
  [in]           DWORD dwWin32Error
)
{...}

매개 변수

[in, optional] hDot11SvcHandle

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

[in, optional] hSecuritySessionID

이전 호출을 통해 반환된 보안 세션 식별자(ID)의 핸들입니다. Dot11ExtIhvPerformPostAssociate IHV 처리기 함수입니다.

[in, optional] pPeer

IHV 확장 DLL이 보안 작업을 수행한 AP(액세스 지점)의 MAC(미디어 액세스 제어) 주소입니다. 이 매개 변수는 DOT11_MAC_ADDRESS 구조체로 형식이 지정됩니다.

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

[in] dwReasonCode

연결 후 작업의 완료 상태에 대한 추가 정보를 제공하는 값입니다. IHV 확장 DLL은 dwReasonCode L2cmn.h에 정의된 L2_REASON_CODE_xxxx 값으로 설정해야 합니다.

IHV 확장 DLL은 dwWin32Error 매개 변수를 통해 연결 후 작업의 일반 완료 상태를 반환합니다. 일반적으로 IHV 확장 DLL은 dwReasonCode L2_REASON_CODE_IHV_BASE 범위 내의 값으로 설정합니다(L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).

[in] dwWin32Error

Winerror.h 내의 오류 코드에 정의된 사후 연결 작업의 완료 상태입니다. 작업이 성공적으로 완료되면 IHV 확장 DLL은 dwWin32Error ERROR_SUCCESS 설정해야 합니다.

반환 값

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

발언

IHV 확장 DLL은 Dot11ExtPostAssociateCompletion 함수를 호출하여 다음을 수행합니다.

에 대한 호출로 시작된 연결 후 작업을 완료합니다. Dot11ExtIhvPerformPostAssociate IHV 처리기 함수입니다.
연결 후 작업을 완료한 후 hSecuritySessionID 매개 변수에서 참조하는 보안 세션의 포트 상태 변경을 나타냅니다.
예를 들어 포트의 권한 부여 상태가 변경되면 IHV 확장 DLL은 Dot11ExtPostAssociateCompletion호출하여 운영 체제에 알릴 수 있습니다.

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

연결 후 작업이 성공적으로 완료되면 IHV 확장 DLL은 dwReasonCode 다음 중 하나로 설정해야 합니다.
- L2_REASON_CODE_SUCCESS.
- L2_REASON_CODE_IHV_BASE 범위의 IHV 정의 값입니다(L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).
이 경우 IHV 확장 DLL은 dwWin32Error ERROR_SUCCESS 설정해야 합니다.
참고 IHV 확장 DLL이 dwWin32Error ERROR_SUCCESS 설정하면 운영 체제는 보안 세션의 포트 상태가 권한 있는 상태라고 가정합니다. 포트가 권한 있는 상태이면 운영 체제에서 WLAN 어댑터를 통해 모든 데이터 패킷을 보낼 수 있습니다.
연결 후 작업이 실패로 완료된 경우 IHV 확장 DLL은 dwReasonCode L2_REASON_CODE_SUCCESS 설정해서는 안 됩니다. 대신 DLL은 dwReasonCode 다음 중 하나로 설정해야 합니다.
- 적절한 L2_REASON_CODE_xxxx 오류 값입니다.
- L2_REASON_CODE_IHV_BASE 범위의 IHV 정의 값입니다(L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).
이 경우 IHV 확장 DLL은 dwWin32Error ERROR_SUCCESS 설정해서는 안 됩니다. 대신 DLL은 dwWin32Error Winerror.h에 정의된 적절한 오류 코드로 설정해야 합니다.
참고 IHV 확장 DLL이 dwWin32Error ERROR_SUCCESS 설정하지 않으면 운영 체제는 보안 세션의 포트 상태가 권한 없는 상태라고 가정합니다. 포트가 권한이 없는 상태가 된 후 운영 체제에서는 Dot11ExtSendPacket IHV Extensions 함수를 통해 전송된 패킷을 포함한 보안 패킷을 WLAN 어댑터를 통해 보낼 수 있습니다.
IHV 확장 DLL은 Dot11ExtIhvAdapterReset 또는 Dot11ExtIhvDeinitAdapter IHV 처리기 함수를 호출할 때마다 보류 중인 모든 연결 후 작업을 취소하려면 Dot11ExtPostAssociateCompletion 호출해야 합니다. 이 경우 DLL은 dwStatus 매개 변수를 ERROR_CANCELLED 설정해야 합니다.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼	바탕 화면
헤더	wlanihv.h(Wlanihv.h 포함)