DOT11EXT_PRE_ASSOCIATE_COMPLETION 콜백 함수(wlanihv.h)

구문

DOT11EXT_PRE_ASSOCIATE_COMPLETION Dot11extPreAssociateCompletion;

DWORD Dot11extPreAssociateCompletion(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in]           DWORD dwReasonCode,
  [in]           DWORD dwWin32Error
)
{...}

매개 변수

[in, optional] hDot11SvcHandle

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

[in, optional] hConnectSession

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

[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은 Dot11ExtPreAssociateCompletion 함수를 호출할 때 다음 지침을 따라야 합니다.

• 사전 연결 작업이 성공적으로 완료되면 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은 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은 Dot11ExtIhvAdapterReset 또는 Dot11ExtIhvDeinitAdapter IHV 처리기 함수가 호출 될 때마다 보류 중인 모든 사전 연결 작업을 취소하려면 Dot11ExtPreAssociateCompletion을 호출해야 합니다. 이 경우 DLL은 dwWin32Error 매개 변수를 ERROR_CANCELLED 설정해야 합니다.

요구 사항

추가 정보

Dot11ExtIhvAdapterReset

Dot11ExtIhvDeinitAdapter

Dot11ExtIhvInitAdapter

네이티브 802.11 IHV 처리기 함수