DOT11_CIPHER_KEY_MAPPING_KEY_VALUE 구조체(windot11.h)

아티클
08/08/2023

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

DOT11_CIPHER_KEY_MAPPING_KEY_VALUE 구조체는 802.11 스테이션의 키 테이블에 추가되거나 삭제될 키 매핑 암호화 키를 정의합니다. 이 암호 키 형식에 대한 자세한 내용은 802.11 암호 키 형식을 참조하세요.

구문

typedef struct DOT11_CIPHER_KEY_MAPPING_KEY_VALUE {
  DOT11_MAC_ADDRESS      PeerMacAddr;
  DOT11_CIPHER_ALGORITHM AlgorithmId;
  DOT11_DIRECTION        Direction;
  BOOLEAN                bDelete;
  BOOLEAN                bStatic;
  USHORT                 usKeyLength;
  UCHAR                  ucKey[1];
} DOT11_CIPHER_KEY_MAPPING_KEY_VALUE, *PDOT11_CIPHER_KEY_MAPPING_KEY_VALUE;

멤버

PeerMacAddr

피어의 MAC 주소입니다. 피어는 802.11 스테이션이 연결된 액세스 지점(AP)(인프라 BSS 네트워크용) 또는 피어 스테이션(독립 BSS 네트워크의 경우)입니다.

이 멤버는 키 항목을 고유하게 식별하는 데 사용됩니다. 표준 802.11 암호화 알고리즘의 경우 운영 체제는 피어의 MAC 주소를 통해 피어를 식별합니다. IHV(독립 하드웨어 공급업체)에서 개발한 독점 암호 알고리즘의 경우 IHV는 모든 메서드를 사용하여 키 항목을 식별할 수 있습니다.

NIC가 ExtAP(확장 가능 액세스 지점) OP 모드에 있는 경우 PeerMacAddr 에는 고유한 값이 있어야 합니다.

AlgorithmId

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

Direction

이 멤버는 802.11 스테이션에서 수신 또는 전송 패킷에 키를 사용할지 여부를 지정합니다. 이 멤버의 데이터 형식은 DOT11_DIRECTION 열거형입니다.

bDelete

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

bStatic

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

FALSE로 설정된 경우 미니포트 드라이버는 다음과 같은 경우 uKeyIndex에서 참조하는 기본 키를 삭제해야 합니다.

802.11 스테이션은 BSS 네트워크에서 연결이 끊어집니다.
피어 스테이션이 BSS 네트워크에서 연결을 끊습니다.
802.11 스테이션은 동일한 BSS 네트워크에 다시 연결됩니다.

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

의 집합 요청을 통해 명시적으로 삭제됨 OID_DOT11_CIPHER_KEY_MAPPING_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 구조체입니다.

ucKey[1]

키 재질입니다.

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

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

설명

Native 802.11 미니포트 드라이버는 PeerMacAddr 및 Direction 멤버를 통해 키 매핑 키를 고유하게 식별합니다. Windows 컴퓨터에 설정 OID_DOT11_CIPHER_KEY_MAPPING_KEY 미니포트 드라이버는 Set 요청의 PeerMacAddr 및 Direction 멤버 값이 기존 키의 멤버와 일치하는 경우에만 기존 키를 수정하거나 삭제할 수 있습니다.

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

bStatic
usKeyLength
ucKey

요구 사항

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