DOT11EXTIHV_QUERY_UI_REQUEST 콜백 함수(wlanihv.h)

구문

DOT11EXTIHV_QUERY_UI_REQUEST Dot11extihvQueryUiRequest;

DWORD Dot11extihvQueryUiRequest(
  [in, optional] HANDLE hIhvExtAdapter,
  [in]           DOT11EXT_IHV_CONNECTION_PHASE connectionPhase,
  [out]          PDOT11EXT_IHV_UI_REQUEST *ppIhvUIRequest
)
{...}

매개 변수

[in, optional] hIhvExtAdapter

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

[in] connectionPhase

현재 연결 단계입니다. 이 멤버의 데이터 형식은 DOT11EXT_IHV_CONNECTION_PHASE 열거형입니다.

connection_phase_any

연결 단계를 지정합니다.

connection_phase_initial_connection

IHV 확장 DLL이 사전 연결 작업을 시작하기 전에 연결 단계를 지정합니다. 사전 연결 작업에 대한 자세한 내용은 사전 연결 작업을 참조하세요.

connection_phase_post_l3_connection

IHV 확장 DLL이 연결 후 작업을 완료한 후 연결 단계를 지정합니다. 연결 후 작업에 대한 자세한 내용은 연결 후 작업을 참조하세요.

[out] ppIhvUIRequest

DOT11EXT_IHV_UI_REQUEST 구조체에 대한 포인터의 주소입니다. IHV 확장 DLL은 Dot11ExtAllocateBuffer를 호출하여 DOT11EXT_IHV_UI_REQUEST 구조체에 대한 버퍼를 할당해야 합니다.

반환 값

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

설명

Dot11ExtIhvQueryUIRequest가 호출되면 IHV 확장 DLL은 DOT11EXT_IHV_UI_REQUEST 구조체로 형식이 지정된 버퍼를 할당하고 반환해야 합니다. 이 경우 DLL은 다음 지침을 따라야 합니다.

• IHV 확장 DLL은 Dot11ExtAllocateBuffer 를 호출하여 버퍼를 할당해야 합니다. DLL이 Dot11ExtIhvQueryUIRequest에서 반환된 후 운영 체제는 Dot11ExtFreeBuffer 를 호출하여 버퍼를 해제합니다.
• IHV 확장 DLL은 연결 상태 변경에 적합한 UI 요청에 대한 DOT11EXT_IHV_UI_REQUEST 구조 형식을 지정합니다.

  예를 들어 connectionPhase 가 connection_phase_initial_connection 설정된 경우 IHV 확장 DLL은 연결 작업의 시작을 사용자에게 알릴 사용자 인터페이스 페이지를 참조하도록 DOT11EXT_IHV_UI_REQUEST 구조체의 멤버를 설정할 수 있습니다.

요구 사항

추가 정보

Dot11ExtAllocateBuffer

DOT11EXT_IHV_UI_REQUEST

Dot11ExtIhvInitAdapter

Dot11ExtFreeBuffer