DOT11EXT_SET_DEFAULT_KEY_ID 콜백 함수(wlanihv.h)

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

 

IHV 확장 DLL은 Dot11ExtSetDefaultKeyId 함수를 호출하여 전송된 패킷 데이터를 암호화할 때 기본적으로 WLAN(무선 LAN) 어댑터가 사용하는 기본 또는 스테이션별 암호 키의 테이블 인덱스를 설정합니다.

구문

DOT11EXT_SET_DEFAULT_KEY_ID Dot11extSetDefaultKeyId;

DWORD Dot11extSetDefaultKeyId(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           ULONG uDefaultKeyId
)
{...}

매개 변수

[in, optional] hDot11SvcHandle

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

[in] uDefaultKeyId

어댑터의 기본 또는 스테이션별 암호 키 테이블 내 키의 인덱스 값입니다.

WEP 또는 TKIP와 같은 표준 802.11 암호 알고리즘의 경우 uDefaultKeyId 는 0에서 3 사이여야 합니다. IHV에서 개발한 독점 암호 알고리즘의 경우 uDefaultKeyId 는 IHV에서 정의한 범위 내의 모든 값일 수 있습니다.

반환 값

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

설명

기본 키 식별자(ID)는 어댑터의 기본 키 및 어댑터가 데이터 암호화에 사용하는 스테이션별 기본 키 테이블에서 암호 키의 인덱스를 지정합니다. 어댑터는 MAC(대상 미디어 액세스 제어) 주소에 대한 키 매핑 키가 없는 한 기본 키 ID에서 참조하는 암호화 키를 전송된 패킷의 기본 암호화 키로 사용합니다. 이러한 암호화 키 형식에 대한 자세한 내용은 802.11 암호 키 형식을 참조하세요.

Dot11ExtSetDefaultKeyId 함수를 호출하면 의 집합 요청이 발생합니다. WLAN 어댑터를 관리하는 Native 802.11 미니포트 드라이버에 OID(개체 식별자)를 OID_DOT11_CIPHER_DEFAULT_KEY_ID.

요구 사항

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

추가 정보

OID_DOT11_CIPHER_DEFAULT_KEY_ID

Dot11ExtIhvInitAdapter

802.11 암호화 키 유형