Share via

Networking_SetHardwareAddress函數

  • 發行項

頁首： #include < applibs/networking。h>

設定網路介面的硬體位址。 硬體位址會在重新開機時持續存在，而且只能設定在 乙太網路介面上。 應用程式 資訊清單 必須包含該 HardwareAddressConfig 功能。

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

參數

  • networkInterfaceName 要更新的網路介面名稱。
  • hardwareAddress 指向包含硬體位址之位元組陣列的指標。
  • hardwareAddressLength 硬體位址的長度。 這應該一律等於 HARDWARE_ADDRESS_LENGTH 。

錯誤

如果發生錯誤並設定為 errno 錯誤值，則傳回 -1。

  • ENOINT：網路介面不存在。

  • EPERM：介面上不允許此函數。

  • EAGAIN：網路堆疊尚未準備就緒。

  • ERANGE：大於 hardwareAddressLengthHARDWARE_ADDRESS_LENGTH 。

  • EINVAL：無效 hardwareAddressLength 。

    範例：

    • 全零硬體位址 (00：00：00：00：00：00：00) 。 -
    • 群組硬體位址 (硬體位址，其第一個八進位的最小有效位設為 1) 。

您可以指定任何其他 errno 錯誤;這類錯誤不是不確定的，而且不保證這些值在作業系統各版本中會保持一致。

傳回值

會傳回 0 表示成功，而失敗則傳回 -1，在這種情況下 errno 會設定為錯誤值。

概念和範例