Funzione Networking_SetHardwareAddressNetworking_SetHardwareAddress Function

Intestazione: #include <applibs/networking.h>Header: #include <applibs/networking.h>

Imposta l'indirizzo hardware per un'interfaccia di rete.Sets the hardware address for a network interface. L'indirizzo hardware viene reso permanente tra i riavvii e può essere impostato solo su un' interfaccia Ethernet.The hardware address is persisted across reboots, and can only be set on an Ethernet interface. Il manifesto dell'applicazione deve includere la HardwareAddressConfig funzionalità.The application manifest must include the HardwareAddressConfig capability.

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

ParametriParameters

  • networkInterfaceName Nome dell'interfaccia di rete da aggiornare.networkInterfaceName The name of the network interface to update.
  • hardwareAddress Puntatore a una matrice di byte che contiene l'indirizzo hardware.hardwareAddress A pointer to an array of bytes containing the hardware address.
  • hardwareAddressLength Lunghezza dell'indirizzo hardware.hardwareAddressLength The length of the hardware address. Deve essere sempre uguale a HARDWARE_ADDRESS_LENGTH .This should always be equal to HARDWARE_ADDRESS_LENGTH.

ErrorsErrors

Restituisce-1 se viene rilevato un errore e imposta sul errno valore di errore.Returns -1 if an error is encountered and sets errno to the error value.

  • ENOINT: l'interfaccia di rete non esiste.ENOINT: the network interface does not exist.

  • EPERM: questa funzione non è consentita per l'interfaccia.EPERM: this function is not allowed on the interface.

  • EAGAIN: lo stack di rete non è pronto.EAGAIN: the networking stack isn't ready.

  • ERANGE: hardwareAddressLength è maggiore di HARDWARE_ADDRESS_LENGTH .ERANGE: the hardwareAddressLength is greater than HARDWARE_ADDRESS_LENGTH.

  • EINVAL: il valore di hardwareAddressLength non è valido.EINVAL: the hardwareAddressLength is invalid.

    Esempi:Examples:

    • Un indirizzo hardware all-zeros (00:00:00:00:00:00).An all-zeroes hardware address (00:00:00:00:00:00). -
    • Raggruppare gli indirizzi hardware (un indirizzo hardware con il bit meno significativo del primo ottetto impostato su 1).Group hardware addresses (a hardware address with its first octet's least significant bit set to 1).

errnoÈ possibile specificare qualsiasi altro tipo di errore. tali errori non sono deterministici e non vi è alcuna garanzia che i valori siano coerenti tra le versioni del sistema operativo.Any other errno may be specified; such errors aren't deterministic and there is no guarantee that the values will be consistent across releases of the OS.

Valore restituitoReturn value

Restituisce 0 per l'esito positivo o-1 per l'esito negativo, nel qual caso errno viene impostato sul valore di errore.Returns 0 for success, or -1 for failure, in which case errno is set to the error value.

Concetti ed esempiConcepts and samples