다음을 통해 공유


WifiConfig_SetTargetedScanEnabled 함수

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

네트워크에 대한 대상 검색을 사용하거나 사용하지 않도록 설정합니다. 대상 검색은 기본적으로 사용하지 않도록 설정됩니다.

대상 검색은 SSID를 브로드캐스트하지 않거나 시끄러운 환경에 있는 액세스 지점에 연결하는 데 사용됩니다.

이 설정은 즉시 적용되지만, 이 함수 다음에 WifiConfig_PersistConfig 함수가 호출되지 않으면 디바이스를 다시 부팅하는 동안 지속되지 않습니다.

Important

대상 지정 검사를 수행하면 디바이스에서 네트워크의 SSID를 공개할 수 있는 프로브 요청을 다른 디바이스로 전송합니다. 이는 제어된 환경 또는 허용되는 위험이 있는 네트워크에서만 사용해야 합니다.

static int WifiConfig_SetTargetedScanEnabled(int networkId, bool enabled);

매개 변수

  • networkId 구성하려는 네트워크의 ID입니다. WifiConfig_AddNetwork 사용하여 새로 만든 네트워크의 네트워크 ID를 반환합니다. 네트워크 ID는 구성을 위해 WifiConfig_Set* 함수에 전달됩니다. WifiConfig_SetSSID 사용하여 검사를 대상으로 지정할 SSID를 지정합니다.

  • enabledtrue 네트워크에서 대상 검색을 사용하도록 설정하려면 이고, false그렇지 않으면 .

Errors

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

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

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

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

  • EINVAL: networkId 매개 변수가 잘못되었습니다.

  • ENODEV: 매개 변수가 networkId 저장된 네트워크와 일치하지 않습니다.

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

반환 값

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

애플리케이션 매니페스트 요건

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