DOT11_CIPHER_DEFAULT_KEY_VALUE 구조체(windot11.h)

아티클
08/08/2023

중요

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

DOT11_CIPHER_DEFAULT_KEY_VALUE 구조는 802.11 스테이션의 키 테이블에서 추가되거나 삭제될 기본 암호 키 또는 스테이션별 기본 암호 키를 정의합니다. 이러한 암호화 키 형식에 대한 자세한 내용은 802.11 암호 키 형식을 참조하세요.

구문

typedef struct DOT11_CIPHER_DEFAULT_KEY_VALUE {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  uKeyIndex;
  DOT11_CIPHER_ALGORITHM AlgorithmId;
  DOT11_MAC_ADDRESS      MacAddr;
  BOOLEAN                bDelete;
  BOOLEAN                bStatic;
  USHORT                 usKeyLength;
  UCHAR                  ucKey[1];
} DOT11_CIPHER_DEFAULT_KEY_VALUE, *PDOT11_CIPHER_DEFAULT_KEY_VALUE;

멤버

Header

DOT11_CIPHER_DEFAULT_KEY_VALUE 구조체의 형식, 수정 버전 및 크기입니다. 이 멤버는 NDIS_OBJECT_HEADER 구조체로 형식이 지정됩니다.

미니포트 드라이버는 헤더 의 멤버를 다음 값으로 설정해야 합니다.

형식

이 멤버는 NDIS_OBJECT_TYPE_DEFAULT 설정해야 합니다.

수정 버전

이 멤버는 DOT11_CIPHER_DEFAULT_KEY_VALUE_REVISION_1 설정해야 합니다.

크기

이 멤버는 로 sizeof(DOT11_CIPHER_DEFAULT_KEY_VALUE)설정해야 합니다.

이러한 멤버에 대한 자세한 내용은 NDIS_OBJECT_HEADER.

uKeyIndex

802.11 스테이션의 기본 키 배열에 있는 키의 인덱스입니다.

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

BIP uKeyIndex 의 경우 4 또는 5여야 합니다.

IEEE 802.11-2012 표준은 기본 키 인덱스 값을 1에서 4까지 정의합니다. 이 멤버 가 지정한 x 값은 802.11 기본 키 인덱스(x + 1)에 매핑됩니다.

AlgorithmId

이 키를 사용하는 암호화 알고리즘의 값입니다. 암호 알고리즘 값에 대한 자세한 내용은 DOT11_CIPHER_ALGORITHM 참조하세요.

BIP의 경우 초기 IGTK 패킷 번호를 미리 설정하려면 DOT11_CIPHER_ALGO_BIP 설정해야 합니다.

bDelete가 TRUE인 경우 미니포트 드라이버는 이 멤버를 무시해야 합니다.

MacAddr

키를 추가하거나 제거할 기본 키 테이블을 식별하는 MAC(미디어 액세스 제어) 주소입니다.

dot11DesiredBSSType MIB(관리 정보 베이스) 개체가 dot11_BSS_type_infrastructure 설정된 경우 802.11 스테이션은 MacAddr 멤버의 값에 관계없이 기본 키 테이블에서 키를 추가하거나 제거합니다. 스테이션이 연결된 AP(액세스 지점)에서 키를 동적으로 가져오는 경우 MacAddr 멤버에는 AP의 MAC 주소가 포함됩니다. 그렇지 않으면 MacAddr 의 값이 0x000000000000.

dot11DesiredBSSType MIB(관리 정보 베이스) 개체가 dot11_BSS_type_independent 설정된 경우 802.11 스테이션은 다음과 같은 방법으로 키를 추가하거나 제거해야 합니다.

이 멤버의 값이 0x000000000000 경우 802.11 스테이션은 기본 키 테이블에서 키를 추가하거나 제거합니다. NIC가 ExtAP(Extensible Access Point) OP 모드에 있는 경우 이 값은 0입니다.
이 멤버의 값이 유효한 유니캐스트 MAC 주소인 경우 802.11 스테이션은 MAC 주소가 MacAddr 와 같은 독립 BSS(IBSS) 네트워크의 피어 스테이션에 대한 스테이션별 기본 키 테이블에서 키를 추가하거나 제거합니다.

MacAddr 값에 대한 스테이션별 기본 키 테이블이 없는 경우 802.11 스테이션은 사용되지 않는 스테이션당 기본 키 테이블을 사용해야 합니다.

dot11DesiredBSSType MIB 개체에 대한 자세한 내용은 OID_DOT11_DESIRED_BSS_TYPE.

bDelete

미니포트 드라이버에서 기본 키를 삭제할지 여부를 지정하는 부울 값입니다.

TRUE로 설정된 경우 미니포트 드라이버는 uKeyIndex에서 참조하는 기본 키를 삭제해야 합니다. FALSE로 설정된 경우 미니포트 드라이버는 uKeyIndex 에서 참조하는 기본 키를 추가하거나 업데이트해야 합니다.

bStatic

미니포트 드라이버가 연결 또는 로밍 작업 후 기본 키를 삭제해야 하는지 여부를 지정하는 부울 값입니다.

FALSE로 설정하면 미니포트 드라이버는 802.11 스테이션이 있을 때마다 uKeyIndex에서 참조하는 기본 키를 삭제해야 합니다.

기본 서비스 집합(BSS) 네트워크에서 연결을 끊습니다.
새 BSS 네트워크로 로밍합니다.
동일한 BSS 네트워크에 다시 연결합니다.

TRUE로 설정하면 다음과 같은 경우가 아니면 uKeyIndex에서 참조하는 기본 키를 삭제하면 안 됩니다.

OID_DOT11_CIPHER_DEFAULT_KEY 집합 요청을 통해 명시적으로 삭제됩니다.
OID_DOT11_RESET_REQUEST 메서드 요청을 통해 암시적으로 삭제됩니다.

usKeyLength

ucKey 배열의 키 재질 길이(바이트)입니다.

ucKey[*]

키 재질입니다.

AlgorithmId가 DOT11_CIPHER_ALGO_TKIP 설정된 경우 ucKey 배열은 DOT11_KEY_ALGO_TKIP_MIC 구조를 통해 키 자료를 정의합니다.

AlgorithmId가 DOT11_CIPHER_ALGO_CCMP 설정된 경우 ucKey 배열은 DOT11_KEY_ALGO_CCMP 구조를 통해 키 자료를 정의합니다.

AlgorithmId가 DOT11_CIPHER_ALGO_BIP 설정된 경우 ucKey 배열은 DOT11_KEY_ALGO_BIP 구조를 통해 키 자료를 정의합니다.

ucKey[1]

키 재질입니다.

AlgorithmId가 DOT11_CIPHER_ALGO_TKIP 설정된 경우 ucKey 배열은 DOT11_KEY_ALGO_TKIP_MIC 구조를 통해 키 자료를 정의합니다.

AlgorithmId가 DOT11_CIPHER_ALGO_CCMP 설정된 경우 ucKey 배열은 DOT11_KEY_ALGO_CCMP 구조를 통해 키 자료를 정의합니다.

AlgorithmId가 DOT11_CIPHER_ALGO_BIP 설정된 경우 ucKey 배열은 DOT11_KEY_ALGO_BIP 구조를 통해 키 자료를 정의합니다.

설명

bDelete 멤버가 TRUE이면 다음 멤버가 유효하지 않으므로 무시해야 합니다.

bStatic
usKeyLength
ucKey

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 운영 체제의 Windows 8 이상 버전에서 사용할 수 있습니다.
머리글	windot11.h(Ndis.h 포함)