Networking_TimeSync_EnableCustomNTP 函数

标头: #include <applibs/networking.h>

指示设备使用用户提供的 NTP 服务器地址。 最多可以指定两个主机名或 IP 地址,如果启用默认服务器,将尝试最多三个。

int Networking_TimeSync_EnableCustomNtp(const char *primaryNtpServer, const char *secondaryNtpServer, Networking_NtpOption option);

参数

  • primaryNtpServer 要使用的主 NTP 服务器地址。
  • secondaryNtpServer 要使用的辅助 NTP 服务器地址。 这可以设置为 NULL。
  • option 启用或禁用默认 NTP 服务器。

错误

如果遇到错误并设置为 errno 错误值,则返回 -1。

  • EFAULT:为 primaryNtpServer NULL。

  • EACCES:调用应用程序没有 TimeSyncConfig 功能。

  • ERANGE: primaryNtpServersecondaryNtpServer 长度大于最大 FQDN 长度或未以 null 结尾。

还可以指定任何其他 errno 错误;此类错误不是确定性的,并且无法保证通过系统更新保留相同的行为。

返回值

如果成功,则返回 0,如果失败,则返回 -1,在这种情况下 errno ,将设置为错误值。

概念和示例