Click to Rate and Give Feedback
MSDN
MSDN Library
WMI Reference
WMI Classes
Win32 Classes
 EnableStatic Method of the Win32_Ne...

  Switch on low bandwidth view
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

MOF
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 codeDescription
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

Minimum supported clientWindows 2000 Professional
Minimum supported serverWindows 2000 Server
MOFCimwin32.mof
DLLCimwin32.dll
Namespace\root\cimv2

See Also

Computer System Hardware Classes
Win32_NetworkAdapterConfiguration

Send comments about this topic to Microsoft

Build date: 6/15/2009

Tags What's this?: Add a tag
Community Content   What is Community Content?
Add new content RSS  Annotations
Win32_NetworkAdapterConfiguration.EnableStatic() returns 81      gougliak1   |   Edit   |   Show History
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.
consequences to returns 81      amro_elroubi ... Thomas Lee   |   Edit   |   Show History
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!!!
Warnings about using EnableStatic remotely      VideoRipper   |   Edit   |   Show History
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...
Flag as ContentBug
A socket operation was attempted to an unreachable host error      Jenson Yin ... Thomas Lee   |   Edit   |   Show History
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&

Windows Vista Lock      Juan Rodríguez-Covili ... Thomas Lee   |   Edit   |   Show History

When trying to use the EnableStatic method on Windows Vista (c# using ManagementClass) for a second time "sometimes" the method returns with an error code that is not on the list: 2147786788... (I use EnableStatic to change the IP for the firs time, it works... then I close the program, then I run it again and fails).

I only have found that the problem maybe is because some other application is "holding the write lock in the TCP notify object".

Some others times it sets the Ip but the network does not work properly (the machine can't see other machines).. so i use the EnableStatic method again.. and the lock problem happens.

If the first call to EnableStatic method holds the write lock to set de Ip configuration.. how can I do to release this lock after the configuration is made???

[tfl - 22 04 09] You should post questions like this to the MSDN Forums at http://forums.microsoft.com/msdn or 
the MSDN Newsgroups at http://www.microsoft.com/communities/newsgroups/en-us/. You are much more likely get a
quicker response using the forums than through the Community Content. For specific help about:
Visual Studio  : http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public.vstudio%2C&
.NET Framework : http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public.dotnet.framework
All Public     : http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public%2C&
Processing
© 2009 Microsoft Corporation. All rights reserved. Terms of Use  |  Trademarks  |  Privacy Statement
Page view tracker