피드백

DOT11EXT_POST_ASSOCIATE_COMPLETION 콜백 함수(wlanihv.h)

  • 아티클
  • 읽는 데 6분 걸림
중요 네이티브 802.11 무선 LAN 인터페이스는 Windows 10 이상에서 사용되지 않습니다. 대신 WDI(WLAN 디바이스 드라이버 인터페이스)를 사용하세요. 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

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

[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을 호출하여 운영 체제에 알릴 수 있습니다.

The IHV Extensions DLL must follow these guidelines when calling the 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 확장 함수를 통해 전송된 패킷을 비롯한 보안 패킷을 WLAN 어댑터를 통해 보낼 수 있습니다.
  • IHV 확장 DLL은 Dot11ExtIhvAdapterReset 또는 Dot11ExtIhvDeinitAdapter IHV 처리기 함수를 호출할 때마다 보류 중인 모든 연결 후 작업을 취소하려면 Dot11ExtPostAssociateCompletion을 호출해야 합니다. 이 경우 DLL은 dwStatus 매개 변수를 ERROR_CANCELLED 설정해야 합니다.

요구 사항

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

참고 항목

Dot11ExtIhvAdapterReset

Dot11ExtIhvDeinitAdapter

Dot11ExtIhvInitAdapter

네이티브 802.11 IHV 처리기 함수

Dot11ExtIhvPerformPostAssociate

DOT11_MAC_ADDRESS

Dot11ExtSendPacket