DOT11EXT_GET_PROFILE_CUSTOM_USER_DATA 콜백 함수(wlanihv.h)

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

 

IHV 확장 DLL은 Dot11ExtGetProfileCustomUserData 함수를 호출하여 BSS(기본 서비스 집합) 네트워크 연결에 사용되는 현재 사용자 및 네트워크 프로필과 관련된 시스템 레지스트리에서 데이터를 검색합니다.

구문

DOT11EXT_GET_PROFILE_CUSTOM_USER_DATA Dot11extGetProfileCustomUserData;

DWORD Dot11extGetProfileCustomUserData(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in]           DWORD dwSessionID,
  [out]          DWORD *pdwDataSize,
  [out]          LPVOID *ppvData
)
{...}

매개 변수

[in, optional] hDot11SvcHandle

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

[in, optional] hConnectSession

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

[in] dwSessionID

현재 사용자의 세션 식별자(세션 ID)입니다.

[out] pdwDataSize

ppvData 에서 참조하는 버퍼의 크기를 바이트 단위로 저장하는 호출자 제공 변수에 대한 포인터입니다.

[out] ppvData

사용자 데이터를 포함하는 버퍼의 주소를 저장하는 포인터 변수의 주소입니다.

반환 값

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

설명

운영 체제는 시스템 레지스트리에서 읽은 후 ppvData 매개 변수에서 참조하는 데이터의 암호를 해독하지 않습니다. IHV 확장 DLL은 Dot11ExtGetProfileCustomUserData를 호출한 후 자체 암호 해독 알고리즘을 사용하여 데이터의 암호를 해독해야 합니다.

네이티브 Wifi AutoConfig 서비스에서 사용하는 모든 무선 WLAN 프로필에 대해 Windows는 사용자 지정 사용자 데이터의 개념을 유지 관리합니다. 이 사용자 지정 사용자 데이터는 처음에는 존재하지 않지만 를 호출하여 설정할 수 있습니다. Dot11ExtSetProfileCustomUserData 함수입니다. 사용자 지정 사용자 데이터는 을 호출하여 프로필이 수정될 때마다 비워지도록 다시 설정됩니다. Dot11ExtSetCurrentProfile 함수입니다.

사용자 지정 사용자 데이터를 설정한 후 Dot11ExtGetProfileCustomUserData 함수를 사용하여 이 데이터에 액세스할 수 있습니다.

호출자는 Dot11ExtFreeBuffer 함수를 사용하여 ppvData 매개 변수가 가리키는 버퍼에 할당된 메모리를 해제합니다.

요구 사항

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

추가 정보

Dot11ExtIhvInitAdapter

Dot11ExtFreeBuffer

Dot11ExtSetProfileCustomUserData Dot11ExtIhvPerformPreAssociate

Dot11ExtSetCurrentProfile