다음을 통해 공유

Networking_GetInterfaces 함수

  • 아티클

헤더: #include <applibs/networking.h>

Azure Sphere 디바이스의 네트워크 인터페이스 목록을 가져옵니다. 가 너무 작아서 시스템의 모든 네트워크 인터페이스를 보유할 수 없을 경우 outNetworkInterfaces 이 함수는 배열을 채우고 배열 요소 수를 반환합니다. 시스템의 인터페이스 수는 부팅 주기 내에서 변경되지 않습니다.

ssize_t Networking_GetInterfaces(Networking_NetworkInterface *outNetworkInterfacesArray, size_t networkInterfacesArrayCount);

매개 변수

  • outNetworkInterfacesArray 네트워크 인터페이스 속성으로 채울 Networking_NetworkInterface 구조체 배열에 대한 포인터입니다. 호출자는 Networking_GetInterfacesCount 호출한 후 배열에 대한 메모리를 할당하여 디바이스의 인터페이스 수를 검색해야 합니다.

  • networkInterfacesArrayCount 보유할 수 있는 요소 outNetworkInterfacesArray 의 수입니다. 배열에는 디바이스의 각 네트워크 인터페이스에 대해 하나의 요소가 있어야 합니다.

오류

오류가 발생하고 를 오류 값으로 설정 errno 하면 -1을 반환합니다.

  • EFAULT: 매개 변수는 outNetworkInterfacesArray NULL입니다.

  • ERANGE: networkInterfacesArrayCount parmaeter는 0입니다.

  • EAGAIN: 네트워킹 스택이 아직 준비되지 않았습니다.

다른 errno 모든 오류도 지정할 수 있습니다. 이러한 오류는 결정적이지 않으며 시스템 업데이트를 통해 동일한 동작이 유지되지 않을 수 있습니다.

반환 값

배열에 추가 outNetworkInterfaces 된 네트워크 인터페이스 수를 반환합니다. 그렇지 않으면 실패의 경우 -1이며, 이 경우 errno 오류 값으로 설정됩니다.

개념 및 샘플