The
EnableWINS WMI class static method enables Windows Internet Naming Service (WINS) settings specific to TCP/IP, but independent of the network adapter.
This topic uses Managed Object Format (MOF) syntax. For more information about using this method, see
Calling a Method.
Syntax
uint32 EnableWINS(
[in] boolean DNSEnabledForWINSResolution,
[in] boolean WINSEnableLMHostsLookup,
[in, optional] string WINSHostLookupFile,
[in, optional] string WINSScopeID
);
Parameters
- DNSEnabledForWINSResolution [in]
-
If true, the Domain Name System (DNS) is enabled for name resolution over WINS resolution.
- WINSEnableLMHostsLookup [in]
-
If true, local lookup files are used. Lookup files will contain mappings of IP addresses to host names.
- WINSHostLookupFile [in, optional]
-
Lookup files that contain mappings of IP addresses to host names. If available, the files will be found in %SystemRoot%\system32\drivers\etc.
- WINSScopeID [in, optional]
-
Scope identifier value that will be appended to the end of the computer's NetBIOS name. Systems that use the same scope identifier can communicate with this computer.
Return Value
Returns a value of 0 (zero) for a successful completion when no reboot is required; 1 (one) for a successful completion when a reboot is required; a different number if there is an error.
| Return code | Description |
| 0 | Successful completion, no reboot required. |
| 1 | Successful completion, reboot required. |
| 64 | Method not supported on this platform. |
| 65 | Unknown failure. |
| 66 | Invalid subnet mask. |
| 67 | An error occurred during processing an instance that was returned. |
| 68 | Invalid input parameter. |
| 69 | More than five gateways specified. |
| 70 | Invalid IP address. |
| 71 | Invalid gateway IP address. |
| 72 | An error occurred while accessing the registry for the requested information. |
| 73 | Invalid domain name. |
| 74 | Invalid host name. |
| 75 | No primary or secondary WINS server defined. |
| 76 | Invalid file. |
| 77 | Invalid system path. |
| 78 | File copy failed. |
| 79 | Invalid security parameter. |
| 80 | Unable to configure TCP/IP service. |
| 81 | Unable to configure DHCP service. |
| 82 | Unable to renew DHCP lease. |
| 83 | Unable to release DHCP lease. |
| 84 | IP not enabled on adapter. |
| 85 | IPX not enabled on adapter. |
| 86 | Frame or network number bounds error. |
| 87 | Invalid frame type. |
| 88 | Invalid network number. |
| 89 | Duplicate network number. |
| 90 | Parameter out of bounds. |
| 91 | Access denied. |
| 92 | Out of memory. |
| 93 | Already exists. |
| 94 | Path, file, or object not found. |
| 95 | Unable to notify service. |
| 96 | Unable to notify DNS service. |
| 97 | Interface not configurable. |
| 98 | Not all DHCP leases could be released or renewed. |
| 100 | DHCP not enabled on adapter. |
Example Code
For script code examples, see WMI Tasks for Scripts and Applications and the TechNet ScriptCenter Script Repository.
For C++ code examples, see WMI C++ Application Examples.
Requirements
| Client | Requires Windows Vista, Windows XP, Windows 2000 Professional, or Windows NT Workstation 4.0 SP4 and later. |
| Server | Requires Windows Server 2008, Windows Server 2003, Windows 2000 Server, or Windows NT Server 4.0 SP4 and later. |
| MOF | Declared in Cimwin32.mof. |
| DLL | Requires Cimwin32.dll. |
| Namespace | Defined in \root\cimv2. |
See Also
Computer System Hardware Classes
Win32_NetworkAdapterConfiguration
Send comments about this topic to Microsoft
Build date: 6/19/2008