Share via


WifiConfig_SetPSK 함수

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

Wi-Fi 네트워크에 대한 PSK(사전 공유 키)를 설정합니다. PSK는 보안 유형으로 WifiConfig_Security_Wpa2_Psk 구성된 네트워크에 사용됩니다.

이 설정은 즉시 유효하지만 이 함수 다음에 WifiConfig_PersistConfig 함수가 호출되지 않는 한 디바이스 재부팅 간에 유지되지 않습니다.

static int WifiConfig_SetPSK(int networkId, const char *psk, size_t pskLength);

매개 변수

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

  • psk 네트워크에 대한 PSK를 포함하는 버퍼에 대한 포인터입니다.

  • pskLength 네트워크의 PSK 길이입니다. 이 매개 변수는 보다 작거나 와 같 WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE아야 합니다.

오류

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

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

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

  • ERANGE: 매개 변수가 pskLength 보다 WIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE큽합니다.

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

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

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

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

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

반환 값

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

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

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