Networking_SetHardwareAddress関数

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

ネットワーク インターフェイスのハードウェア アドレスを設定します。 ハードウェア アドレスは再起動後も保持され、 イーサネット インターフェイスでのみ設定できます。 アプリケーション マニフェストには、機能がHardwareAddressConfig含まれている必要があります。

static int Networking_SetHardwareAddress(const char *networkInterfaceName, const uint8_t *hardwareAddress, size_t hardwareAddressLength);

パラメーター

• networkInterfaceName 更新するネットワーク インターフェイスの名前。
• hardwareAddress ハードウェア アドレスを含むバイト配列へのポインター。
• hardwareAddressLength ハードウェア アドレスの長さ。 これは常に と HARDWARE_ADDRESS_LENGTH等しい必要があります。

エラー

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

• ENOINT: ネットワーク インターフェイスが存在しません。

• EPERM: この関数はインターフェイスでは使用できません。

• EAGAIN: ネットワーク スタックの準備ができていない。

• ERANGE: が hardwareAddressLength より HARDWARE_ADDRESS_LENGTH大きい。

• EINVAL: が hardwareAddressLength 無効です。

  例:

  • all-zeroes ハードウェア アドレス (00:00:00:00:00:00)。 -
  • ハードウェア アドレスをグループ化します (最初のオクテットの最下位ビットが 1 に設定されているハードウェア アドレス)。

その他 errno のエラーは指定できます。このようなエラーは決定的ではなく、OS のリリース間で値が一貫性を持つ保証はありません。

戻り値

成功の場合は 0、失敗の場合は -1 を返します。この場合 errno はエラー値に設定されます。

概念とサンプル

• サンプル: プライベート ネットワーク サービス