GetAdaptersInfo

Description:	Returns TRUE whenever the network interface configuration of the local computer changes. (For example, turning off WiFi or plugging in a network adapter.) Current network configuration is returned in the parameter.
Returns:	Boolean.
Usage:	Steady State only.
Function Groups:	Network and Workstation
Related to:
Format:	GetAdaptersInfo(Info)
Parameters:

Info

Optional. A variable that will be assigned a dictionary describing the current networking configuration of the local computer.

Comments:

The dictionary maintained in variable Info, has 3 members. Each of the members holds an array of equal size, with one element per network interface. "InterfaceID" Holds the interface ID number that Windows has assigned to the network interface. "Name" Holds the textual name of the interface. "UniqueID" Holds a UUID assigned to the interface by Windows.

Example:

  If GetAdaptersInfo(NetworkInfo);
  [
    NumInterfaces = ArraySize(NetworkInfo["InterfaceID"]);
    I = 0;
    WhileLoop(I < NumInterfaces,
       InterfaceInfo = Concat("ID: ", NetworkInfo["InterfaceID"][I], " Name: ", NetworkInfo["Name"][I], " UniqueID: ", NetworkInfo["UniqueID"][I]);
       I++;
    );
  ]

This will set InterfaceInfo to a string describing each network interface in turn.