Intrfc.exe Programmatically Retrieves IP Interface Info. (186312)



The information in this article applies to:

  • Microsoft Windows 2000 Server
  • Microsoft Windows 2000 Advanced Server
  • Microsoft Windows 2000 Professional
  • Microsoft Windows NT Server 4.0
  • Microsoft Windows NT Workstation 4.0
  • Microsoft Windows 98
  • Microsoft Windows 95

This article was previously published under Q186312

SUMMARY

Intrfc.exe is a sample that demonstrates how to programmatically enumerate IP interface information, such as a system's IP address, subnet mask, and broadcast address, using the WSAIoctl() API with the SIO_GET_INTERFACE_LIST option. In addition, Intrfc.exe demonstrates how to interpret IP status flags for each IP interface. The flags are defined in the Windows Sockets 2 Protocol-Specific Annex specification which can be found in the January 98 MSDN Platform SDK or later.

MORE INFORMATION

If you are using Windows NT 4.0 with Service Pack 3 or earlier, there is a problem with the SIO_GET_INTERFACE_LIST option. Please see the following knowledge base article for further information:

For additional information, please see the following article in the Microsoft Knowledge Base:

181520 BUG: WSAIoctl SIO_GET_INTERFACE_LIST Option Problem

The following file is available for download from the Microsoft Download Center:
For additional information about how to download Microsoft Support files, click the following article number to view the article in the Microsoft Knowledge Base:

119591 How to Obtain Microsoft Support Files from Online Services

Microsoft scanned this file for viruses. Microsoft used the most current virus-detection software that was available on the date that the file was posted. The file is stored on security-enhanced servers that help to prevent any unauthorized changes to the file.

Intrfc.exe contains the following files:
  • Readme.txt.
  • Intrfc.cpp: The main source code module for this sample.
  • Makefile: The compiler control file to generate an executable for Intrfc.exe.
To compile this application, simply execute NMake.exe from the command line and it will generate Intrfc.exe.

To run this application, simply execute Interface.exe.

Modification Type:MinorLast Reviewed:12/16/2004
Keywords:kbAPI kbfile kbIP kbnetwork kbSample kbWinsock KB186312