Share via

WifiConfig_StoreWpa2Network 함수

  • 아티클

헤더: #include <applibs/wificonfig.h>

중요

이 함수는 사용되지 않습니다. 대신 WifiConfig_AddNetwork 사용합니다.

미리 공유된 키를 사용하는 WPA2 Wi-Fi 네트워크를 저장합니다. 이 함수는 스레드로부터 안전하지 않습니다.

참고

동일한 SSID 및 미리 공유된 키가 있는 네트워크가 이미 저장된 경우 이 함수는 실패합니다. 오류 섹션(EEXIST)을 참조하세요.

int WifiConfig_StoreWpa2Network(const uint8_t * ssid, size_t ssidLength, const char * psk, size_t pskLength);

매개 변수

  • ssid Wi-Fi 네트워크를 식별하는 지정되지 않은 문자 인코딩이 있는 SSID 바이트 배열에 대한 포인터입니다.

  • ssidLength Wi-Fi 네트워크의 SSID에 있는 바이트 수입니다.

  • psk Wi-Fi 네트워크에 대한 미리 공유된 키가 포함된 버퍼에 대한 포인터입니다.

  • pskLength Wi-Fi 네트워크에 대한 미리 공유된 키의 길이입니다.

오류

오류가 발생하고 를 오류 값으로 설정 errno 하면 -1을 반환합니다.

  • EACCES: 애플리케이션 매니페스트에는 WifiConfig 기능이 포함되지 않습니다.

  • EEXIST: SSID가 동일하고 WPA2를 사용하는 저장된 Wi-Fi 네트워크가 이미 있습니다.

  • EFAULT: 또는 psk 가 ssid NULL입니다.

  • ERANGE: ssidLength 또는 pskLength 매개 변수가 및 WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE보다 0 이상 WIFICONFIG_SSID_MAX_LENGTH 입니다.

  • EAGAIN: Wi-Fi 디바이스가 아직 준비되지 않았습니다.

  • ENETDOWN: Wi-Fi 네트워크 인터페이스를 사용할 수 없습니다.

  • ENOSPC: 구성을 유지하기에는 Wi-Fi 네트워크가 너무 많습니다. 을 제거하고 다시 시도하십시오.

다른 errno 모든 오류도 지정할 수 있습니다. 이러한 오류는 결정적이지 않으며 시스템 업데이트를 통해 동일한 동작이 유지되지 않을 수 있습니다.

반환 값

성공의 경우 0을 반환하고 실패의 경우 -1을 반환합니다. 이 경우 errno 오류 값으로 설정됩니다.

애플리케이션 매니페스트 요구 사항

애플리케이션 매니페스트에는 WifiConfig 기능이 포함되어야 합니다.