DOT11_CIPHER_KEY_MAPPING_KEY_VALUE 구조체(windot11.h)
구문
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 네트워크에 다시 연결됩니다.
- 의 집합 요청을 통해 명시적으로 삭제됨 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 포함) |