다음을 통해 공유


WifiConfig_GetNetworkIdByConfigName 함수

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

지정된 이름의 네트워크 구성에 대한 네트워크 ID를 가져옵니다. WifiConfig_SetConfigName 사용하여 네트워크 이름을 할당합니다. 네트워크 구성이 추가되고 제거되면 네트워크 ID가 변경될 수 있으므로 앱은 저장된 네트워크 구성을 변경하기 전에 네트워크 ID를 다시 가져와야 합니다.

int WifiConfig_GetNetworkIdByConfigName(const char *configName);

매개 변수

  • configName 네트워크 구성의 이름에 대한 포인터입니다. 이 이름은 WifiConfig_SetConfigName 사용하여 설정되었습니다. 문자열은 NULL로 종료되어야 하며 바이트보다 작거나 같 WIFICONFIG_CONFIG_NAME_MAX_LENGTH 아야 합니다(종료 제외).

오류

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

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

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

  • ERANGE: 매개 변수가 configName 보다 WIFICONFIG_SSID_MAX_LENGTH큽합니다.

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

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

  • ENODEV: 지정된 네트워크 구성을 찾을 수 없습니다.

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

반환 값

지정된 네트워크의 네트워크 ID(음수가 아닌 값) 또는 실패의 경우 -1을 반환합니다. 이 경우 errno 오류 값으로 설정됩니다. 네트워크 ID는 구성할 네트워크의 식별자로 WifiConfig_Setxxx 함수에 전달됩니다.

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

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