Microsoft KB Archive/940658

= You cannot programmatically unregister a multi-homed alias record from a Windows Server 2003-based WINS server =

Article ID: 940658

Article Last Modified on 11/26/2007

-

APPLIES TO


 * Microsoft Windows Server 2003, Datacenter Edition (32-bit x86)
 * Microsoft Windows Server 2003, Enterprise Edition (32-bit x86)
 * Microsoft Windows Server 2003, Standard Edition (32-bit x86)
 * Microsoft Windows Server 2003, Datacenter Edition for Itanium-Based Systems
 * Microsoft Windows Server 2003, Datacenter x64 Edition
 * Microsoft Windows Server 2003, Enterprise Edition for Itanium-based Systems
 * Microsoft Windows Server 2003, Enterprise x64 Edition
 * Microsoft Windows Server 2003, Standard x64 Edition

-



SYMPTOMS
You use a program to register an alias record with a Windows Server 2003-based Windows Internet Name Service (WINS) server. In this scenario, when you try to programmatically unregister the alias record, you experience the following symptoms:
 * The WINS server sends a STATUS_SUCCESS result to the computer that submitted the request to unregister the alias record.
 * The alias record is not deleted from the WINS database.

Therefore, you cannot use the program to unregister the alias record from a WINS server.

This problem occurs if the following conditions are true:
 * The program registers a multi-homed WINS alias record.
 * The WINS alias record is registered together with an IP address that is not the primary IP address of the computer.



CAUSE
This problem occurs because of how WINS manages database records.

The WINS database maintains ownership of the records by using the primary IP address of the computer that registered the record. When WINS receives a request to unregister a record, WINS uses the primary IP address of the computer to locate the database record. If WINS cannot locate the database record by using the primary IP address of the computer, WINS determines that the record has already been released. Therefore, WINS returns a STATUS_SUCCESS result to the computer that submitted the request. However, WINS does not unregister the appropriate record.

Note For more information about this behavior, see the &quot;More Information&quot; section.



WORKAROUND
To work around this problem, manually remove or tombstone the record from the WINS server database.

Note If the organization has only one WINS server, you can either delete or tombstone the appropriate record. However, for an organization that has more than one WINS server, you must tombstone the record.

To delete or to tombstone a record, follow these steps:
 * 1) Start the WINS Microsoft Management Console (MMC) snap-in.
 * 2) Expand the server name, and then click Active Registrations.
 * 3) On the Action menu, click Display Records.
 * 4) On the Record Mapping tab, click to select the Filter records matching this Name pattern check box, type all or part of the alias name in the box that is under this check box, and then click Find Now.
 * 5) Right-click the appropriate record, and then click Delete.
 * 6) In the Delete Record dialog box, click one of the following options, as appropriate:
 * 7) * Delete the record only from this server
 * 8) * Replicate for deletion of the record to other servers (tombstone)
 * 9) Click OK.

For more information about how to delete and tombstone records in WINS, visit the following Microsoft Web site:

http://technet2.microsoft.com/windowsserver/en/library/adf22ad1-ffe5-401d-8d42-70b2906e06101033.mspx?mfr=true



STATUS
Microsoft has confirmed that this is a problem in the Microsoft products that are listed in the &quot;Applies to&quot; section.



MORE INFORMATION
This problem occurs in the following scenario:
 * 1) A workstation computer that is named WS-1 has an IP address of 192.168.1.100.
 * 2) You use a program to create an alias that is named &quot;WS-1-alias&quot; and that has an IP address of 192.168.1.200.
 * 3) The program successfully registers a multi-homed workstation record that is named &quot;WS-1-alias&quot; together with the IP address of 192.168.1.200.
 * 4) The program tries to unregister the &quot;WS-1-alias&quot; alias from the WINS database.
 * 5) WINS tries to locate the &quot;WS-1-alias&quot; record by using the primary IP address of 192.169.1.100.
 * 6) WINS cannot locate the &quot;WS-1-alias&quot; record. Therefore, WINS determines that the record is already unregistered.
 * 7) WINS returns a STATUS_SUCCESS result to the computer that has an IP address of 192.168.1.100 (WS-1).
 * 8) The &quot;WS-1-alias&quot; record remains in the WINS database.

For more information about how to locate records in WINS, visit the following Microsoft Web site:

http://technet2.microsoft.com/windowsserver/en/library/d9752e34-fefc-4709-84b3-9127c68bd3841033.mspx?mfr=true

Keywords: kbnofix kbbug kbtshoot kbprb KB940658

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.