次の方法で共有

Networking_GetInterfaces関数

  • [アーティクル]

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

Azure Sphere デバイス内のネットワーク インターフェイスの一覧を取得します。 が小さすぎてシステム内のすべてのネットワーク インターフェイスを保持できる場合 outNetworkInterfaces 、この関数は配列を埋め、配列要素の数を返します。 システム内のインターフェイスの数は、ブート サイクル内では変更されません。

ssize_t Networking_GetInterfaces(Networking_NetworkInterface *outNetworkInterfacesArray, size_t networkInterfacesArrayCount);

パラメーター

  • outNetworkInterfacesArray ネットワーク インターフェイスプロパティで埋める Networking_NetworkInterface 構造体の配列へのポインター。 呼び出し元は、 Networking_GetInterfacesCountを呼 び出してデバイス上のインターフェイスの数を取得した後、配列のメモリを割り当てる必要があります。

  • networkInterfacesArrayCount 保持できる要素 outNetworkInterfacesArray の数。 配列には、デバイス上のネットワーク インターフェイスごとに 1 つの要素が必要です。

エラー

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

  • EFAULT: パラメーターは outNetworkInterfacesArray NULL です。

  • ERANGE: networkInterfacesArrayCount パルマイターは 0 です。

  • EAGAIN: ネットワーク スタックの準備がまだ整っていません。

その他 errno のエラーも指定できます。このようなエラーは決定的ではなく、同じ動作はシステム更新によって保持されない可能性があります。

戻り値

配列に追加されたネットワーク インターフェイスの数を outNetworkInterfaces 返します。 それ以外の場合、エラーの場合は -1。この場合 errno はエラー値に設定されます。

概念とサンプル