ssCore.SysInfo.getAdaptersInfo

Retrieves information about the configured network adapters (requires IPHLPAPI.DLL).


Availability:

First available in version 3.8 build 333.


Input Parameters:

None.


Output Parameters:

result - Information about the configured network adapters in XML format. See Notes section below for details.


Asynchronous Mode:

When this method is called asynchronously, a return object containing the output parameters is passed to the specified callback function.

ssCore.SysInfo.getAdaptersInfo( paramsObject [, callbackParamsObject] [, errorParamsObject] );


Synchronous Mode:

When this method is called synchronously, a return object containing the output parameters is returned to the caller immediately.

var returnObject = ssCore.SysInfo.getAdaptersInfo( paramsObject );


Notes:

None.


Examples:

var return_obj = ssCore.SysInfo.getAdaptersInfo({});

ssDebug.trace(return_obj.result);

Sample Output

<adapters>
   <adapter>
      <name><![CDATA[{A0B2CD99-39AB-33DC-D0CE-BEF5CA345761}]]></name>
      <description><![CDATA[Broadcom NetXtreme 57xx Gigabit Controller - Packet Scheduler Miniport]]></description>
      <macaddress><![CDATA[00-88-18-C6-3D-4E]]></macaddress>
      <dhcp>10.0.0.1</dhcp>
      <ipaddresslist>
         <ipaddress address="10.0.0.126" mask="255.255.255.0" />
      </ipaddresslist>
      <gatewaylist>
         <ipaddress address="10.0.0.1" mask="0.0.0.0" />
      </gatewaylist>
   </adapter>
   <adapter>
      <name><![CDATA[{29D061E8-80B9-1287-DDDE-25A067184762}]]></name>
      <description><![CDATA[Intel(R) PRO/Wireless 3945ABG Network Connection - Packet Scheduler Miniport]]></description>
      <macaddress><![CDATA[00-99-AC-9A-FF-22]]></macaddress>
      <dhcp>255.255.255.255</dhcp>
      <ipaddresslist>
         <ipaddress address="" mask="" />
      </ipaddresslist>
      <gatewaylist>
         <ipaddress address="" mask="" />
      </gatewaylist>
   </adapter>
</adapters>