DOT11_CIPHER_KEY_MAPPING_KEY_VALUE 구조체(windot11.h)
중요하다
WiFiCx Windows 11에서 릴리스된 새로운 Wi-Fi 드라이버 모델입니다. WiFiCx를 사용하여 최신 기능을 활용하는 것이 좋습니다. WDI 드라이버 모델은 이제 유지 관리 모드에 있으며 높은 우선 순위 수정만 받습니다.
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(Extensible Access Point) OP 모드에 있는 경우 PeerMacAddr 고유한 값이 있어야 합니다.
AlgorithmId
이 키를 사용하는 암호 알고리즘의 값입니다. 암호 알고리즘의 열거자 값에 대한 자세한 내용은 DOT11_CIPHER_ALGORITHM참조하세요.
Direction
이 멤버는 802.11 스테이션에서 수신 또는 전송 패킷에 키를 사용할지 여부를 지정합니다. 이 멤버의 데이터 형식은 DOT11_DIRECTION 열거형입니다.
bDelete
TRUE설정하면 미니포트 드라이버는 PeerMacAddr 참조하는 키를 삭제하고 방향 합니다. FALSE 설정하면 미니포트 드라이버는 PeerMacAddr 및 Direction 참조하는 키를 추가하거나 업데이트해야 합니다.
bStatic
미니포트 드라이버가 연결 또는 로밍 작업 후 기본 키를 삭제할지 여부를 지정하는 부울 값입니다.
false 설정하면 미니포트 드라이버는 uKeyIndex 참조하는 기본 키를 언제든지 삭제해야 합니다.
- 802.11 스테이션은 BSS 네트워크에서 연결을 끊습니다.
- 피어 스테이션이 BSS 네트워크에서 연결을 끊습니다.
- 802.11 스테이션은 동일한 BSS 네트워크에 다시 연결됩니다.
- 의 집합 요청을 통해 명시적으로 삭제됨 OID_DOT11_CIPHER_KEY_MAPPING_KEY.
- OID_DOT11_RESET_REQUEST메서드 요청을 통해 암시적으로 삭제됩니다.
usKeyLength
ucKey 배열의 키 재질 길이(바이트)입니다.
ucKey[*]
키 자료입니다.
AlgorithmIdDOT11_CIPHER_ALGO_TKIP설정된 경우 ucKey 배열은 다음을 통해 키 자료를 정의합니다. DOT11_KEY_ALGO_TKIP_MIC 구조체입니다.
AlgorithmIdDOT11_CIPHER_ALGO_CCMP설정된 경우 ucKey 배열은 다음을 통해 키 자료를 정의합니다. DOT11_KEY_ALGO_CCMP 구조체입니다.
ucKey[1]
키 자료입니다.
AlgorithmIdDOT11_CIPHER_ALGO_TKIP설정된 경우 ucKey 배열은 다음을 통해 키 자료를 정의합니다. DOT11_KEY_ALGO_TKIP_MIC 구조체입니다.
AlgorithmIdDOT11_CIPHER_ALGO_CCMP설정된 경우 ucKey 배열은 다음을 통해 키 자료를 정의합니다. DOT11_KEY_ALGO_CCMP 구조체입니다.
발언
Native 802.11 미니포트 드라이버는 PeerMacAddr 및 Direction 멤버를 통해 키 매핑 키를 고유하게 식별합니다. 의 경우 OID_DOT11_CIPHER_KEY_MAPPING_KEY 설정되면 미니포트 드라이버는 PeerMacAddr 값과 set 요청의 Direction 멤버가 기존 키의 멤버와 일치하는 경우에만 기존 키를 수정하거나 삭제할 수 있습니다.
bDelete 멤버가 TRUE 경우 다음 멤버는 유효하지 않으므로 무시해야 합니다.
- bStatic
- usKeyLength
- ucKey
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
| 헤더 | windot11.h(Ndis.h 포함) |