Share via

EnableDevice method of the CIM_NetworkPort class

  • Article

[Some information relates to pre-released product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.]

The EnableDevice method has been deprecated in lieu of the more general RequestStateChange method that directly overlaps with the functionality provided by this method.

Requests that the LogicalDevice be enabled ("Enabled" input parameter = TRUE) or disabled (= FALSE). If successful, the Device\'s StatusInfo/EnabledState properties should reflect the desired state (enabled/disabled). Note that this method\'s function overlaps with the RequestedState property. RequestedState was added to the model to maintain a record (i.e., a persisted value) of the last state request. Invoking the EnableDevice method should set the RequestedState property appropriately.

The return code should be 0 if the request was successfully executed, 1 if the request is not supported and some other value if an error occurred. In a subclass, the set of possible return codes could be specified, using a ValueMap qualifier on the method. The strings to which the ValueMap contents are \'translated\' may also be specified in the subclass as a Values array qualifier.

Syntax

uint32 EnableDevice(
  [in] boolean Enabled
);

Parameters

  • Enabled [in]
    If TRUE enable the device, if FALSE disable the device.

Return value

TBD

Requirements

Minimum supported client

 Windows 8

Minimum supported server

 Windows Server 2012

Namespace

root\standardcimv2

MOF

 NetTCPIP.mof

DLL

 NetTCPIP.dll

See also

CIM_NetworkPort