次の方法で共有

WifiConfig_GetNetworkIdByConfigName関数

  • [アーティクル]

ヘッダー: applibs </wificonfig.h #include>

指定した名前のネットワーク構成のネットワーク ID を取得します。 ネットワーク名を割り当てるには、WifiConfig_SetConfigNameを使用します。 ネットワーク構成が追加および削除されると、ネットワーク ID が変更される可能性があるため、アプリは保存されているネットワーク構成を変更する前にネットワーク ID を再度取得する必要があります。

int WifiConfig_GetNetworkIdByConfigName(const char *configName);

パラメーター

  • configName ネットワーク構成の名前へのポインター。 この名前は 、WifiConfig_SetConfigNameを使用して設定されました。 文字列は NULL で終わる必要があり、バイト以下 WIFICONFIG_CONFIG_NAME_MAX_LENGTH である必要があります (終了を除く)。

エラー

エラーが発生した場合は -1 を返し、エラー値に設定します errno 。

  • 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 機能が含まれている必要があります。