다음을 통해 공유


WifiConfig_AddDuplicateNetwork 함수

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

지정된 ID를 사용하여 지정된 네트워크의 중복된 새 네트워크를 추가합니다. 새 네트워크에 지정된 이름이 할당되고 기본적으로 사용하지 않도록 설정됩니다.

int WifiConfig_AddDuplicateNetwork(int networkId, const char *configName);

매개 변수

  • networkId 중복할 네트워크의 ID입니다. WifiConfig_AddNetwork 네트워크 ID를 반환합니다.

  • configName 구성 이름을 포함하는 바이트 배열에 대한 포인터입니다. 배열은 NULL 종료되어야 하며 종료 문자를 제외한 최대 WIFICONFIG_CONFIG_NAME_MAX_LENGTH 바이트여야 합니다.

오류

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

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

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

  • EEXIST: 는 configName 고유하지 않습니다.

  • EFAULT: 는 configName NULL입니다.

  • EINVAL: 가 networkId 잘못되었습니다.

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

  • ENODEV: 는 networkId 저장된 네트워크와 일치하지 않습니다.

  • ENOMEM: 새 네트워크를 추가할 메모리가 부족합니다.

  • ERANGE: 에는 configName 문자가 1개 미만이거나 WIFICONFIG_CONFIG_NAME_MAX_LENGTH 개 이상의 문자가 있습니다.

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

반환 값

새 네트워크의 ID를 반환하거나 실패의 경우 -1을 반환합니다. 이 경우 errno 오류 값으로 설정됩니다. 네트워크 ID가 0이거나 양수 값입니다.

발언

새 네트워크가 구성되지 않았으며 WifiConfig_Set* 함수를 사용하여 구성할 수 있습니다. 네트워크 구성에 대한 변경 내용은 즉시 유효하지만 비휘발성 스토리지에 구성을 저장하기 위해 WifiConfig_PersistConfig 함수가 호출되지 않는 한 디바이스가 다시 부팅되면 손실됩니다.

디바이스에 저장할 수 있는 네트워크 수는 고정되어 있지 않지만 사용 가능한 리소스와 각 네트워크 구성에 필요한 스토리지 양에 따라 달라집니다.

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

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