WifiConfig_StoreOpenNetwork 함수

아티클
08/09/2023

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

중요

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

키 없이 열린 Wi-Fi 네트워크를 저장합니다. 이 함수는 스레드로부터 안전하지 않습니다.

동일한 네트워크가 키 없이 디바이스에 이미 저장된 경우 이 함수는 실패합니다. 오류 섹션(EEXIST)을 참조하세요. 그러나 저장된 네트워크에 동일한 SSID와 함께 키가 포함된 경우 이 함수는 성공하고 네트워크를 저장합니다.

int WifiConfig_StoreOpenNetwork(const uint8_t * ssid, size_t ssidLength);

매개 변수

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

오류

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

EACCES: 애플리케이션 매니페스트에는 WifiConfig 기능이 포함되지 않습니다.
EEXIST: SSID가 동일하고 키가 아직 없는 저장된 Wi-Fi 네트워크입니다.
EFAULT: 는 ssid NULL입니다.
ERANGE: 가 ssidLength 0이거나 WIFICONFIG_SSID_MAX_LENGTH 이상입니다.
EAGAIN: Wi-Fi 디바이스가 아직 준비되지 않았습니다.
ENETDOWN: Wi-Fi 네트워크 인터페이스를 사용할 수 없습니다.
ENOSPC: 구성을 유지하기에는 Wi-Fi 네트워크가 너무 많습니다. 을 제거하고 다시 시도하십시오.

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

반환 값

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

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

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