DOT11EXT_SET_DEFAULT_KEY 콜백 함수(wlanihv.h)

아티클
03/05/2024

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

IHV 확장 DLL은 Dot11ExtSetDefaultKey 함수를 호출하여 WLAN(무선 LAN) 어댑터의 기본 키 또는 스테이션별 기본 키 테이블에서 암호 키를 추가하거나 삭제합니다. 이러한 키 형식에 대한 자세한 내용은 802.11 암호 키 형식을 참조하세요.

구문

DOT11EXT_SET_DEFAULT_KEY Dot11extSetDefaultKey;

DWORD Dot11extSetDefaultKey(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           PDOT11_CIPHER_DEFAULT_KEY_VALUE pKey,
  [in]           DOT11_DIRECTION dot11Direction
)
{...}

매개 변수

[in, optional] hDot11SvcHandle

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

[in] pKey

에 대한 포인터입니다. 암호화 키를 정의하는 DOT11_CIPHER_DEFAULT_KEY_VALUE 구조체입니다.

[in] dot11Direction

키를 받은 패킷( DOT11_DIR_INBOUND )에만 사용할 수 있는지 또는 수신 및 전송된 패킷(DOT11_DIR_BOTH)에만 사용할 수 있는지 여부를 지정하는 DOT11_DIRECTION 값입니다.

참고 IHV 확장 DLL은 이 매개 변수에 DOT11_DIR_OUTBOUND 값을 전달해서는 안 됩니다.

반환 값

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

설명

Dot11ExtSetDefaultKey 함수를 호출하면 의 집합 요청이 발생합니다. WLAN 어댑터에 개체 식별자를 OID_DOT11_CIPHER_DEFAULT_KEY.

기본 암호 키는 의 MacAddr 멤버를 설정하여 정의됩니다. 구조 체를 0x000000000000 값으로 DOT11_CIPHER_DEFAULT_KEY_VALUE. 스테이션별 기본 암호 키는 MacAddr 멤버를 유효한 MAC(유니캐스트 미디어 액세스 제어) 주소로 설정하여 정의됩니다.

의 bDelete 멤버인 경우 어댑터의 키 테이블에서 암호 키가 삭제됩니다. DOT11_CIPHER_DEFAULT_KEY_VALUE 구조체는 TRUE로 설정됩니다.

요구 사항

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