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:大於
hardwareAddressLength
HARDWARE_ADDRESS_LENGTH
。EINVAL:無效
hardwareAddressLength
。範例:
- 全零硬體位址 (00:00:00:00:00:00:00) 。 -
- 群組硬體位址 (硬體位址,其第一個八進位的最小有效位設為 1) 。
您可以指定任何其他 errno
錯誤;這類錯誤不是不確定的,而且不保證這些值在作業系統各版本中會保持一致。
傳回值
會傳回 0 表示成功,而失敗則傳回 -1,在這種情況下 errno
會設定為錯誤值。