Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
[Windows Virtual PC is no longer available for use as of Windows 8. Instead, use the Hyper-V WMI provider (V2).]
Turns off the virtual machine.
Syntax
HRESULT TurnOff(
[out, retval] IVMTask **turnOffTask
);
Parameters
-
turnOffTask [out, retval]
-
An IVMTask object that is used to track the completion progress of the virtual machine's turnoff sequence.
Return value
This method can return one of these values.
| Return code/value | Description |
|---|---|
|
The operation was successful. |
|
The parameter is NULL. |
|
The caller must have execute access permissions to turn off this virtual machine. |
|
The virtual machine is not running. |
|
The configuration is unknown. |
|
An unexpected error has occurred. |
Remarks
This method turns off the virtual machine in the same manner as turning the power off on a physical machine.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows 7 [desktop apps only] |
| Minimum supported server |
None supported |
| End of client support |
Windows 7 |
| Product |
Windows Virtual PC |
| Header |
|
| IID |
IID_IVMVirtualMachine is defined as f7092aa1-33ed-4f78-a59f-c00adfc2edd7 |