IVMGuestOS::OSName property
[Windows Virtual PC is no longer available for use as of Windows 8. Instead, use the Hyper-V WMI provider (V2).]
Retrieves the name of the guest operating system running in the virtual machine (VM).
This property is read-only.
Syntax
HRESULT get_OSName(
[out, retval] BSTR *guestOSName
);
Property value
The full name (including suite name) of the guest operating system.
Error codes
| Name/value | Meaning |
|---|---|
|
The operation was successful. |
|
The parameter is NULL. |
|
The VM is not running. |
|
Integration components are not installed in this VM. |
|
An unexpected error has occurred. |
Remarks
The VM must be running (that is, fully booted and not shutting down) and integration components must be installed when this method is invoked.
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_IVMGuestOS is defined as 99fea0db-4880-499a-b6d8-73dff9bc91be |