DOT11EXT_GET_PROFILE_CUSTOM_USER_DATA 콜백 함수(wlanihv.h)

구문

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 매개 변수가 가리키는 버퍼에 할당된 메모리를 해제합니다.

요구 사항

추가 정보

Dot11ExtIhvInitAdapter

Dot11ExtFreeBuffer

Dot11ExtSetCurrentProfile