MSFT_NetTransportConnection 类的 RequestStateChange 方法
请求将元素的状态更改为 RequestedState 参数中指定的值。 当请求的状态更改发生时，元素的 EnabledState 和 RequestedState 将相同。 多次调用 RequestChangeState 方法可能会导致早期请求被覆盖或丢失。 如果返回 0，则表明任务已成功完成，并且不需要使用 ConcreteJob。 如果返回 4096 (0x1000)，则表明任务需要一些时间才能完成，此时将创建 ConcreteJob，并在输出参数 Job 中返回其引用。 任何其他返回代码均指示错误条件。
语法
uint32 RequestStateChange(
[in] uint16 RequestedState,
[out] CIM_ConcreteJob Job,
[in] datetime TimeoutPeriod
);
参数
-
RequestedState [in]
-
元素的最后请求状态或所需状态。 如果 RequestStateChange 方法的返回代码为 0（“已完成且无错误”）、3（“超时”）或 4096 （0x1000） （“作业已启动”），则此信息将放入实例的 RequestedState 属性中。 有关 RequestedState 值的详细说明，请参阅 EnabledState 和 RequestedState 属性的说明。
-
启用 (2)
-
已禁用 (3)
-
关闭 (4)
-
脱机 (6)
-
测试 (7)
-
延迟 (8)
-
静止 (9)
-
重新启动 (10)
-
重置 (11)
-
DMTF 保留 （12 32767）
-
供应商预留 (32768 65535)
-
-
作业 [out]
-
包含对作业的引用的 CIM_ConcreteJob（如果任务完成，可以为 null）。
-
TimeoutPeriod [in]
-
一个超时时间段，指定客户端期望转换到新状态所花费的最大时间。 间隔格式必须用于指定此时间段。 值为 0 或 null 参数表示客户端没有转换时间要求。 如果此属性不包含 0 或 null，并且实现不支持此参数，则必须返回“使用超时参数不支持”的返回代码。
返回值
-
已完成，无错误 (0)
-
不支持 (1)
-
未知或未指定错误 (2)
-
无法在超时期限内完成 (3)
-
失败 (4)
-
无效参数 (5)
-
正在使用中 (6)
-
DMTF 保留 (7 4095)
-
检查的方法参数 - 作业已启动 (4096)
-
无效的状态转换 (4097)
-
不支持使用超时参数 (4098)
-
忙碌 (4099)
-
方法保留 (4100 32767)
-
供应商特定 (32768 65535)
要求
| 最低受支持的客户端 |
Windows 8 |
| 支持的最低服务器版本 |
Windows Server 2012 |
| 命名空间 |
Root\standardcimv2 |
| MOF |
|
| DLL |
|