IVMVirtualMachine::AddHardDiskConnection 方法
[自Windows 8起,Windows 虚拟电脑不再可供使用。 请改用 Hyper-V WMI 提供程序 (V2) 。]
将新的硬盘连接添加到虚拟机 (VM) 。
语法
HRESULT AddHardDiskConnection(
[in] BSTR hardDiskPath,
[in] long busNumber,
[in] long deviceNumber,
[out, retval] IVMHardDiskConnection **hardDiskConnection
);
parameters
-
hardDiskPath [in]
-
虚拟硬盘的完整路径 (要连接的 VHD) 文件。
-
busNumber [in]
-
驱动器将连接到的总线。
值 含义 - 0
驱动器将连接到第一个总线。 - 1
驱动器将连接到第二个总线。 -
deviceNumber [in]
-
驱动器将连接到的设备。
值 含义 - 0
驱动器将连接到总线上的第一个设备。 - 1
驱动器将连接到总线上的第二台设备。 -
hardDiskConnection [out, retval]
返回值
此方法可以返回其中一个值。
返回代码/值 | 说明 |
---|---|
|
操作成功。 |
|
hardDiskConnection 参数为 NULL。 |
|
hardDiskPath 参数为 NULL,或者 busNumber 或 deviceNumber 参数无效。 |
|
系统找不到 由 hardDiskPath 参数指定的文件。 |
|
系统找不到 由 hardDiskPath 参数指定的路径。 |
|
hardDiskPath 参数包含无效字符 (“*?<>/|“:”) 。 |
|
hardDiskPath 参数指定空路径或相对路径。 绝对路径是必需的。 |
|
hardDiskPath 参数指定的路径太长。 路径必须小于 260 个字符。 |
|
配置未知。 |
|
VM 处于运行或保存状态。 |
|
指定的总线位置正在使用中。 |
|
VHD 大于 127 GB,无法连接到 IDE 总线。 |
|
hardDiskPath 参数引用链接的 VHD 或与链接 VHD 的差异 VHD。 链接的 VHD 不能附加到虚拟机。 |
|
指定的 VHD 已连接到此 VM 的另一个总线位置。 |
|
发生意外错误。 |
备注
只能将新的硬盘连接添加到已停止的虚拟机。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows 7 [仅限桌面应用] |
最低受支持的服务器 |
无受支持的版本 |
客户端支持终止 |
Windows 7 |
产品 |
Windows Virtual PC |
标头 |
|
IID |
IID_IVMVirtualMachine定义为 f7092aa1-33ed-4f78-a59f-c00adfc2edd7 |