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

  Switch on low bandwidth view
EnableDHCP Method of the Win32_NetworkAdapterConfiguration Class

The EnableDHCP WMI class method enables the Dynamic Host Configuration Protocol (DHCP) for service with this network adapter. DHCP allows IP addresses to be dynamically allocated.
This topic uses Managed Object Format (MOF) syntax. For more information about using this method, see Calling a Method.

Syntax

MOF
uint32 EnableDHCP();

Parameters

This method has no parameters.

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 the 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
Does not clear any static default gateways      Pankaj Sarda   |   Edit   |   Show History

This method does not clears any static default gateways present on the machin.

Is there any other way to accomplish this?

Tags What's this?: Add a tag
Flag as ContentBug
Does not clear old gateways in Windows Vista      Darkvoid   |   Edit   |   Show History
Using this method in Windows Vista does not clear old gateways with the new ones from DHCP. Works fine in Windows XP
Tags What's this?: Add a tag
Flag as ContentBug
Processing
© 2009 Microsoft Corporation. All rights reserved. Terms of Use  |  Trademarks  |  Privacy Statement
Page view tracker