Partilhar via

Função Networking_GetInterfaces

  • Artigo

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

Obtém a lista de interfaces de rede num dispositivo do Azure Sphere. Se outNetworkInterfaces for demasiado pequena para conter todas as interfaces de rede no sistema, esta função preenche a matriz e devolve o número de elementos de matriz. O número de interfaces no sistema não será alterado num ciclo de arranque.

ssize_t Networking_GetInterfaces(Networking_NetworkInterface *outNetworkInterfacesArray, size_t networkInterfacesArrayCount);

Parâmetros

  • outNetworkInterfacesArray Um ponteiro para uma matriz de Networking_NetworkInterface estrutura para preencher com propriedades da interface de rede. O autor da chamada tem de alocar memória para a matriz depois de chamar Networking_GetInterfacesCount para obter 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

Devolve -1 se for encontrado um erro e define errno para o valor de erro.

  • EFAULT: o outNetworkInterfacesArray parâmetro é NULL.

  • ERANGE: o networkInterfacesArrayCount parmaeter é 0.

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

Também pode ser especificado qualquer outro errno ; esses erros não são deterministas e o mesmo comportamento pode não ser retido através de atualizações do sistema.

Valor devolvido

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

Conceitos e exemplos