EnableStatic Method of the Win32_NetworkAdapterConfiguration Class (Windows)

EnableStatic Method of the Win32_Ne...

EnableStatic Method of the Win32_NetworkAdapterConfiguration Class

The EnableStatic WMI class method enables static TCP/IP addressing for the target network adapter. As a result, DHCP for this network adapter is disabled.

This topic uses Managed Object Format (MOF) syntax. For more information about using this method, see Calling a Method.

Syntax

uint32 EnableStatic(
  [in]  string IPAddress[],
  [in]  string SubnetMask[]
);

Parameters

IPAddress [in]: Lists all of the static IP addresses for the current network adapter. Example: 155.34.22.0.
SubnetMask [in]: Subnet masks that complement the values in the IPAddress parameter. Example: 255.255.0.0.

Return Value

Returns a value of 0 (zero) for a successful completion when a reboot is not required, 1 (one) for a successful completion when a reboot is required, and any other 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 while 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.

Examples

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.

When using Win32_NetworkAdapterConfiguration.EnableStatic() to give an adapter a static IP configuration, the function returns an "81 - Unable to configure DHCP service" if the adapter is already configured with a static address. However, the function still succeeds in setting with the new operation.

Tags

: contentbug (x) Add a tag

consequences to returns 81

amro_elroubi | Edit |

When using Win32_NetworkAdapterConfiguration.EnableStatic() to give an adapter a static IP configuration, the function returns an 81 and still function is working but consequences is when using SetDNSServerSearchOrder() it will return 94 and still both function are working!!!

Tags

: Add a tag

Flag as ContentBug

Warnings about using EnableStatic remotely

VideoRipper | Edit |

When trying to use Win32_NetworkAdapterConfiguration.EnableStatic() remotely to change the IP-address of the remote computer, while being connected through that adapter, you obviously loose connection and will get an RPC not available error-message (the settings are changed however). You might want to change the Gateway and/or DNS-settings prior to setting the adapter's IP-address...

Tags

: remote (x) Add a tag

Flag as ContentBug

A socket operation was attempted to an unreachable host error

Jenson Yin ... Thomas Lee | Edit |

My NIC have two IPs, I use EnableStatic() to release the master IP and make the second IP to be the master IP. Then I will create a socket, when execute connect(), it will return a A socket operation was attempted to an unreachable host error. After I wait a while and call connect again, it is ok? Anyone meet the same problem? The OS I use is vista x86, also vista x64 and longhorn x64 have the same problem.

[tfl - 15 Aug 08] You should post questions like this to the Technet Forums at http://forums.microsoft.com/technet or the MS Newsgroups at http://www.microsoft.com/communities/newsgroups/en-us/. You are much more likely get a quick response using the forums than through the Community Content.
For specific help about:
Windows : http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public.windows%2C&

Tags

: needforum (x) neednewsgroup (x) Add a tag

Flag as ContentBug

Manage Your Profile | Legal | Contact Us | MSDN Flash Newsletter

Product Families

Resources

About Microsoft

Popular Places

Popular Searches

Popular Downloads

Syntax

Parameters

Return Value

Examples

Requirements

See Also