Networking_SetHardwareAddress függvény
Fejléc: #include <applibs/networking.h>
Beállítja a hálózati adapter hardvercímét. A hardvercím az újraindítások során megmarad, és csak Ethernet-felületen állítható be. Az alkalmazásjegyzéknek tartalmaznia kell a képességet HardwareAddressConfig
.
static int Networking_SetHardwareAddress(const char *networkInterfaceName, const uint8_t *hardwareAddress, size_t hardwareAddressLength);
Paraméterek
-
networkInterfaceName
A frissíteni kívánt hálózati adapter neve. -
hardwareAddress
A hardvercímet tartalmazó bájttömbre mutató mutató. -
hardwareAddressLength
A hardvercím hossza. Ennek mindig egyenlőnek kell lennie.HARDWARE_ADDRESS_LENGTH
Hibák
-1 értéket ad vissza, ha hiba történik, és a hibaértékre van halmazva errno
.
ENOINT: a hálózati adapter nem létezik.
EPERM: ez a függvény nem engedélyezett a felületen.
EAGAIN: a hálózati verem nem áll készen.
ERANGE: a
hardwareAddressLength
nagyobb, mintHARDWARE_ADDRESS_LENGTH
.EINVAL: a
hardwareAddressLength
érvénytelen.Példák:
- Egy all-zeroes hardvercím (00:00:00:00:00:00). -
- Hardvercímek csoportosítása (egy hardvercím, amelynek első oktettjének legkevésbé jelentős bitje 1-esre van állítva).
errno
Más is megadható; az ilyen hibák nem determinisztikusak, és nem garantálható, hogy az értékek konzisztensek lesznek az operációs rendszer kiadásaiban.
Visszatérési érték
0 értéket ad vissza a sikerhez, vagy -1 hibát, amely esetben errno
a hibaérték van beállítva.