CIM_NetworkPort 类的 QuiesceDevice 方法

QuiesceDevice 方法已被弃用,取而代之的是与此方法提供的功能直接重叠的更通用的 RequestStateChange 方法。

请求 LogicalDevice 完全停止所有当前活动(“静止”输入参数 = TRUE)或恢复活动 (= FALSE)。 若要使此方法静止设备,该设备应具有“正在运行/全功率”的 Availability(或 Additional Availability)(值 = 3),且 EnabledStatus/StatusInfo 的值应为“已启用”。 例如,如果静止,则设备可能会脱机进行诊断,或禁用以进行断电和热插拔。 若要使此方法“取消静止”设备,该设备应具有“已静止”的 Availability(或 AdditionalAvailability)(值 = 21),且 EnabledStatus/StatusInfo 的值应为“已启用”。 在这种情况下,设备将返回到“已启用”和“正在运行/全功率”状态。

方法的返回代码应指示静止成功还是失败。 如果成功,返回 0;如果请求根本不受支持,返回 1;如果请求因设备的当前状态而不受支持,返回 2;如果发生任何其他错误,则返回其他值。 在子类中,可使用该方法上的 ValueMap 限定符指定可能的返回代码集。 ValueMap 内容“转换”到的字符串也可以在子类中指定为Values 数组限定符。

语法

uint32 QuiesceDevice(
  [in] boolean Quiesce
);

参数

Quiesce [in]

如果设置为 TRUE,完全停止所有活动;如果为 FALSE,则恢复活动。

返回值

待定

要求

最低受支持的客户端
Windows 8
支持的最低服务器版本
Windows Server 2012
命名空间
Root\standardcimv2
MOF
NetTCPIP.mof
DLL
NetTCPIP.dll

另请参阅

CIM_NetworkPort