Share via

WifiConfig_GetStoredNetworks 함수

  • 아티클

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

디바이스에 저장된 모든 Wi-Fi 네트워크를 검색합니다. 이 함수는 스레드로부터 안전하지 않습니다.

참고

WifiConfig_GetStoredNetworks 호출하기 전에 WifiConfig_GetStoredNetworkCount 호출하고 결과를 매개 변수로 전달되는 WifiConfig_StoredNetwork 배열의 배열 크기로 storedNetworkArray 사용해야 합니다.

  • 가 너무 작아서 저장된 모든 Wi-Fi 네트워크를 보유할 수 없을 경우 storedNetworkArray 이 함수는 배열을 채우고 배열 요소 수를 반환합니다.

  • WiFiConfig 기능이 없는 경우 함수는 빈 배열을 반환합니다.

ssize_t WifiConfig_GetStoredNetworks(WifiConfig_StoredNetwork * storedNetworkArray, size_t storedNetworkArrayCount);

매개 변수

  • storedNetworkArray 저장된 Wi-Fi 네트워크를 반환하는 배열에 대한 포인터입니다.

  • storedNetworkArrayCount 보유할 수 있는 요소 storedNetworkArray 의 수입니다. 배열에는 저장된 각 Wi-Fi 네트워크에 대해 하나의 요소가 있어야 합니다.

오류

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

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

  • EFAULT: 매개 변수는 storedNetworkArray NULL입니다.

  • ERANGE: 매개 변수는 storedNetworkArrayCount 0입니다.

  • EINVAL: storedNetworkArray 매개 변수 또는 구조체 버전이 잘못되었습니다.

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

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

반환 값

WifiConfig_StoredNetwork 배열의 요소 수를 반환하거나 실패의 경우 -1을 반환합니다. 이 경우 errno 오류 값으로 설정됩니다.

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

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