Compartilhar via

Função Networking_GetInterfaces

  • Artigo

Cabeçalho: #include <applibs/networking.h>

Obtém a lista de interfaces de rede em um dispositivo do Azure Sphere. Se outNetworkInterfaces for muito pequena para manter todas as interfaces de rede no sistema, essa função preencherá a matriz e retornará o número de elementos de matriz. O número de interfaces no sistema não será alterado em um ciclo de inicialização.

ssize_t Networking_GetInterfaces(Networking_NetworkInterface *outNetworkInterfacesArray, size_t networkInterfacesArrayCount);

Parâmetros

  • outNetworkInterfacesArray Um ponteiro para uma matriz de Networking_NetworkInterface structs a serem preenchidos com propriedades da interface de rede. O chamador deve alocar memória para a matriz depois de chamar Networking_GetInterfacesCount para recuperar o número de interfaces no dispositivo.

  • networkInterfacesArrayCount O número de elementos outNetworkInterfacesArray pode conter. A matriz deve ter um elemento para cada interface de rede no dispositivo.

Erros

Retorna -1 se um erro for encontrado e definir errno como o valor do erro.

  • EFAULT: o outNetworkInterfacesArray parâmetro é NULL.

  • ERANGE: o networkInterfacesArrayCount parmaeter é 0.

  • EAGAIN: a pilha de rede ainda não está pronta.

Qualquer outro errno também pode ser especificado; esses erros não são determinísticos e o mesmo comportamento pode não ser mantido por meio de atualizações do sistema.

Valor retornado

Retorna o número de interfaces de rede adicionadas à outNetworkInterfaces matriz. Caso contrário , -1 para falha, nesse caso errno , é definido como o valor do erro.

Conceitos e exemplos