IVdsSubSystem：：SetControllerStatus 方法 (vdshwprv.h)
[从Windows 8和Windows Server 2012开始，虚拟磁盘服务 COM 接口由 Windows 存储管理 API 取代。]
(子系统中控制器的联机或脱机) 设置状态。
语法
HRESULT SetControllerStatus(
[in] VDS_OBJECT_ID *pOnlineControllerIdArray,
[in] LONG lNumberOfOnlineControllers,
[in] VDS_OBJECT_ID *pOfflineControllerIdArray,
[in] LONG lNumberOfOfflineControllers
);
参数
[in] pOnlineControllerIdArray
指向控制器 GUID 数组的指针。 提供程序将这些控制器设置为联机。 此数组包含已设置为“联机”的控制器，这些控制器将保持联机状态。
[in] lNumberOfOnlineControllers
pOnlineControllersArray 中指定的控制器数。
[in] pOfflineControllerIdArray
指向控制器 GUID 数组的指针。 提供程序将这些控制器设置为脱机。 此数组包含已设置为脱机的控制器，这些控制器将保持脱机状态。
[in] lNumberOfOfflineControllers
pOfflineControllersArray 中指定的控制器数。
返回值
此方法可以返回标准 HRESULT 值，例如E_INVALIDARG或E_OUTOFMEMORY，以及 特定于 VDS 的返回值。 它还可以使用 HRESULT_FROM_WIN32 宏返回转换的系统错误代码。 错误可能源自 VDS 本身或正在使用的基础 VDS 提供程序 。 可能的返回值包括以下内容。
| 返回代码/值 | 说明 |
|---|---|
|
此返回值表示提供程序内部存在软件或通信问题，该提供程序缓存有关数组的信息。 使用 IVdsHwProvider：：Reenumerate 方法，后跟 IVdsHwProvider：：Refresh 方法还原缓存。 |
|
子系统对象不再存在。 |
|
子系统处于失败状态，无法执行请求的操作。 |
|
另一个操作正在进行中：在上一个操作完成之前，此操作无法继续。 |
|
可以从采用 VDS_OBJECT_ID 常量的任何方法返回。 此返回值指示标识符不引用现有对象。 |
注解
此方法使调用方能够同时设置所有控制器的状态。 使用 IVdsController：：SetStatus 方法可设置单个控制器的状态。
调用方必须在 pOnlineControllerIdArray 或 pOfflineControllerIdArray 参数中为每个方法调用传递完整的控制器集。 E_INVALIDARG返回值可以指示子系统中的所有控制器都已在此方法的参数中指定。
SetControllerStatus 方法要求子系统中的所有控制器都存在于提供的两个数组之一中。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | vdshwprv.h |
| Library | Uuid.lib |