Developer

API Reference

IDNSConfig2_SelectNetworkEx()

Brew Release
Brew MP 1.0.2
See Also
Data networks Socket Address Family
Description
This function selects a specific data network.
Parameters
  • me
    []:
    the interface pointer
  • nNetwork
    []:
    data network type (AEE_NETWORK_*)
  • nFamily
    []:
    address family (AEE_AF_*)
Interface
Prototype
   int IDNSConfig2_SelectNetworkEx(IDNSConfig2* me, int nNetwork, uint16 nFamily)
Return
AEE_SUCCESS: the data network was selected AEE_NET_EINVAL: the network is not valid AEE_NET_EOPNOTSUPP: the network has already been selected. AEE_EFAILED: other error.
Other error codes are also possible.
Side Effect
None.
Comment
Most applications will not need to explicitly select the network.
When an IDNS instance is created, no network is selected. If an IDNS method that requires a network is called before IDNSConfig2_SelectNetworkEx(), AEE_NETWORK_DEFAULT and AEE_AF_INET will be implicitly selected, and the decision of which network to actually use is deferred to lower layers. Decision will be made upon connection creation, depending on the device and/or service provider.
Once a network has been selected, either explicitly via IDNSConfig2_SelectNetworkEx(), or implicitly as described above, the network may not be changed. To use a different network, a new IDNS instance is required.
  • Follow