Knowledge Base

PRB: gethostbyname() Retrieves Only One IP Address from WINS

Article ID: 192128

Article Last Modified on 7/11/2005

APPLIES TO

This article was previously published under Q192128

SYMPTOMS

When gethostbyname() attempts to resolve a host name of a multihomed computer, it might fail to list all of the IP addresses that were registered with Windows Internet Name Service (WINS) by the multihomed computer.

CAUSE

The gethostbyname() only reads the first address entry in the WINS response.

RESOLUTION

Configure Microsoft Windows TCP/IP to resolve host names using a Domain Name Server (DNS) and register all IP addresses of the multihomed computer in the DNS.

STATUS

This behavior is by design.

MORE INFORMATION

WINS is an extension of RFC 1001/1002 that provides name resolution of NETBIOS computer names. In addition to HOSTS file and DNS, you can configure Microsoft Windows TCP/IP to resolve host names using WINS. If you configure DNS, HOSTS file, and WINS, the gethostbyname() tries to resolve a host name using name services in the following order:
  1. HOSTS file
  2. DNS Server
  3. WINS Server
  4. Local Broadcasting
  5. LMHOSTS file
If the host name of a multihomed computer is found by a DNS Server, gethostbyname() can resolve the name to all IP addresses of the computer that are registered to the DNS. If they are not found by the DNS Server, it attempts to resolve the name by using WINS. The WINS server responds with a list of all IP addresses that were registered with WINS by the computer. However, the gethostbyname() can only parse the first address in the list.

Keywords: kbwinsock kbnetwork kbprb KB192128


Send feedback to Microsoft

© Microsoft Corporation. All rights reserved.